Create a project for the user's website. If the user already has a project for that domain, the tool returns it and does not make a second one. A project the user owns comes before a teammate's project.
Use the URL the user gave you. Only pass competitors and prompts the user asked for. Project limits are the same as on the website.
Capabilities
- Normalize the domain from a URL and derive a company name and a unique slug.
- Return the existing project when the user already has one for that domain.
- Track competitors, up to 10 brand names or domains. A domain such as
globex.comalso removes that site from aiseo_list_missing_sources. - Add prompts, up to 20, with the same plan limits as aiseo_add_prompts.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Website URL or domain |
name | string | No | Company name. Defaults to a name from the domain |
country | string | No |
Input
{
"url": "https://acme.com",
"competitors": ["Globex", "Initech"],
"prompts": ["best crm for startups"]
}
Output
{
"status": "created",
"project": {
"id": "x1y2z3",
"name": "Acme",
"slug": "acme",
"domain": "acme.com",
"country": "US",
"href": "/p/acme/reports"
},
"competitorsAdded": 2,
"promptsAdded": 1,
"nextStep": "Scans are not active for this project. Call `aiseo_activate_plan` with projectSlug \"acme\" to preview the $49 audit or a Basic/Pro plan. Ask the user before you confirm a payment."
}
| Field | Meaning |
|---|---|
status | created | existing |
project | The project to pass as projectSlug to other tools |
competitorsAdded | Competitor names saved as tracked |
competitorsError | Present when competitors were not saved |
promptsAdded | New prompts stored |
promptsError | Present when prompts were not saved, for example over the plan limit |
Next
- aiseo_activate_plan to unlock scans
- MCP tools