AutomateLab AI SEO Magic Button

Generate a whole-site AI-SEO plan

generate_seo_plan

Read-onlyIdempotent

Crawl a site, run a whole-site AEO/GEO audit (via the ai-seo + citation-intelligence engines), and return a portable, agent-executable plan.json plus a markdown checklist. This produces an actionable PLAN, not direct edits.

Input Schema

Name	Required	Description
`pages`	No	Max pages to audit (default 10)
`domain`	Yes	Site to audit — hostname or origin, e.g. example.com
`include_info`	No	Include purely-informational findings (non-actionable notes). Off by default.

Output Schema

Name	Required	Description	Default
`items`	Yes
`target`	Yes
`summary`	Yes
`generator`	Yes
`generated_at`	Yes
`schema_version`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed20 schema fields changedOct 22, 2026

removedOutput schema / properties / domain

Removed value: -{
-  "type": "string"
-}

addedOutput schema / properties / generator
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / properties / items / items / properties / action / additionalProperties
```
Removed value: -false
```

addedOutput schema / properties / items / items / properties / action / anyOf

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "out_path": {
+        "type": "string"
+      },
+      "params": {
+        "additionalProperties": false,
+        "properties": {
+          "domain": {
+            "type": "string"
+          },
+          "max_pages": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "domain"
+        ],
+        "type": "object"
+      },
+      "tool": {
+        "const": "llms_txt_generate",
+        "type": "string"
+      },
+      "type": {
+        "const": "generate_llms_txt",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "tool",
+      "params",
+      "out_path"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "out_path": {
+        "type": "string"
+      },
+      "params": {
+        "additionalProperties": false,
+        "properties": {
+          "domain": {
+            "type": "string"
+          },
+          "pricing_url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "domain"
+        ],
+        "type": "object"
+      },
+      "tool": {
+        "const": "pricing_generate",
+        "type": "string"
+      },
+      "type": {
+        "const": "generate_pricing_md",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "tool",
+      "params",
+      "out_path"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "params": {
+        "additionalProperties": false,
+        "properties": {
+          "format": {
+            "type": "string"
+          },
+          "max_words": {
+            "type": "number"
+          },
+          "target_query": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "target_query"
+        ],
+        "type": "object"
+      },
+      "tool": {
+        "const": "rewrite_aeo",
+        "type": "string"
+      },
+      "type": {
+        "const": "rewrite_aeo",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "tool",
+      "params"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "params": {
+        "additionalProperties": false,
+        "properties": {
+          "add_comparison_table": {
+            "type": "boolean"
+          },
+          "max_words": {
+            "type": "number"
+          },
+          "target_query": {
+            "type": "string"
+          },
+          "text": {
+            "type": "string"
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "target_query"
+        ],
+        "type": "object"
+      },
+      "tool": {
+        "const": "rewrite_geo",
+        "type": "string"
+      },
+      "type": {
+        "const": "rewrite_geo",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "tool",
+      "params"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "jsonld": {
+        "additionalProperties": {},
+        "type": "object"
+      },
+      "type": {
+        "const": "insert_schema",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "jsonld"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "instructions": {
+        "type": "string"
+      },
+      "type": {
+        "const": "manual",
+        "type": "string"
+      }
+    },
+    "required": [
+      "type",
+      "instructions"
+    ],
+    "type": "object"
+  }
+]

removedOutput schema / properties / items / items / properties / action / properties

Removed value: -{
-  "params": {
-    "additionalProperties": {},
-    "type": "object"
-  },
-  "tool": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / items / items / properties / action / required
```
Removed value: -[
-  "tool",
-  "params"
-]
```
removedOutput schema / properties / items / items / properties / action / type
```
Removed value: -"object"
```

changedOutput schema / properties / items / items / properties / category / enum

Previous value: -[
-  "schema",
-  "structure",
-  "citation",
-  "content"
-]New value: +[
+  "schema",
+  "structure",
+  "robots",
+  "technical",
+  "freshness",
+  "llms_txt",
+  "citation",
+  "evidence",
+  "trust",
+  "entity",
+  "content"
+]

addedOutput schema / properties / items / items / properties / failure_signal
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / items / items / properties / id
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / items / items / properties / leading_indicator
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / items / items / properties / priority
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / items / items / properties / rationale
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / items / items / properties / source_file
```
Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}
```

changedOutput schema / properties / items / items / required

Previous value: -[
-  "url",
-  "category",
-  "severity",
-  "title",
-  "expected_score_delta",
-  "action",
-  "acceptance"
-]New value: +[
+  "id",
+  "url",
+  "source_file",
+  "category",
+  "severity",
+  "title",
+  "rationale",
+  "priority",
+  "expected_score_delta",
+  "action",
+  "acceptance"
+]

removedOutput schema / properties / pages_audited
```
Removed value: -{
-  "type": "number"
-}
```

addedOutput schema / properties / schema_version

Added value: +{
+  "const": "1.0",
+  "type": "string"
+}

addedOutput schema / properties / summary

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "avg_score": {
+      "type": "number"
+    },
+    "by_severity": {
+      "additionalProperties": {
+        "type": "number"
+      },
+      "propertyNames": {
+        "enum": [
+          "critical",
+          "high",
+          "medium",
+          "low",
+          "info"
+        ]
+      },
+      "type": "object"
+    },
+    "est_total_delta": {
+      "type": "number"
+    },
+    "grade": {
+      "type": "string"
+    },
+    "pages_audited": {
+      "type": "number"
+    },
+    "platform_readiness": {
+      "additionalProperties": false,
+      "properties": {
+        "chatgpt": {
+          "type": "number"
+        },
+        "gemini": {
+          "type": "number"
+        },
+        "google_ai_overview": {
+          "type": "number"
+        },
+        "perplexity": {
+          "type": "number"
+        }
+      },
+      "type": "object"
+    },
+    "score_caps": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "total_items": {
+      "type": "number"
+    }
+  },
+  "required": [
+    "pages_audited",
+    "avg_score",
+    "grade",
+    "total_items",
+    "est_total_delta",
+    "by_severity"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / target
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / required

Previous value: -[
-  "domain",
-  "pages_audited",
-  "generated_at",
-  "items"
-]New value: +[
+  "schema_version",
+  "target",
+  "generated_at",
+  "generator",
+  "summary",
+  "items"
+]

First observedOct 2, 2026

TDQS

A4/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive, open-world, so 'not direct edits' largely restates structured data. The description does add useful context about the underlying crawl and audit engines, but says nothing about crawl cost, latency, failure behavior, or the 50-page hard ceiling's implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two sentences, front-loaded with the crawl/audit action and the returned artifacts, followed by one crisp scoping clarification. No filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and full parameter documentation, the description only needs to convey purpose and the plan-vs-edit distinction, which it does. Minor gap: nothing about how long a crawl takes or how partial failures are reported.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both the domain format and the pages cap (default 10, max 50) are already documented. The description adds no parameter-level detail beyond the general 'whole-site' framing — which is slightly at odds with the default 10-page cap — so baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Names a specific verb chain (crawl, audit, generate) and concrete artifacts (plan.json, markdown checklist), and scopes it as an AEO/GEO whole-site audit powered by named engines. An agent can tell exactly what comes back without opening the output schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The sentence 'This produces an actionable PLAN, not direct edits' clearly delineates the intended use case and rules out expecting mutations. There are no sibling tools to route against, so no alternatives are needed, but no explicit when-not-to-use conditions (e.g. single-page audits, sites behind auth) are given.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AutomateLab AI SEO Magic Button tools Inspect

Try in Browser

Give agents eyes on the webHosted screenshot MCP. Send a URL, get a pixel-perfect image. $0.002 per grab. Works with Claude, Cursor, and Codex.grabbit.liveAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?