# AI Digital Marketing Portal

The AI Digital Marketing Portal is an autonomous content engine designed to build keyword target campaigns, generate long-form SEO/GEO articles using Google Gemini, and synchronize/publish posts automatically to WordPress domains.

## Core Capabilities

- **Campaign Pipelines**: Configure target keywords, custom frequencies (Daily, Weekly, Bi-weekly, Monthly), and post volumes.
- **AI Article Generation**: Generates comprehensive 800+ word HTML articles based on brand keywords and installs flat-illustration heroes uploaded to Firebase GCS storage.
- **Website Analysis**: Scrapes homepage nodes and utilizes Gemini models to identify target niches and recommend keyword collections.
- **WordPress Integration**: Immediately publishes or schedules generated posts directly to WordPress sites via an API sync wrapper.

## Developer API

The platform provides a customer RESTful API versioned under `/api/v1` and secured with Bearer tokens corresponding to the user's `secret_key`.

### Principal Endpoints

- `GET|POST /api/v1/campaigns` — Manage writing campaigns.
- `GET|PATCH|DELETE /api/v1/campaigns/{id}` — Manage details and review statistics.
- `GET /api/v1/articles` — Retrieve generated content items.
- `POST /api/v1/articles/generate` — Trigger immediate AI article generation.
- `POST /api/v1/articles/{id}/sync` — Sync post to connected WordPress website.
- `GET|POST /api/v1/website` — Manage website profile configuration.
- `POST /api/v1/website/analyze` — Trigger an AI audit on the connected domain.

Full OpenAPI 3.0 specs are available at: [/openapi.json](/openapi.json)