Agents Reference

All six agents are accessible at Account → SEO Agents. Each agent has a dedicated form page, a polling status screen, and a persistent result page.

Keyword Research

Slug: keyword-research | Category: Research | SERP data: Yes | Est. time: 30 s

Generates a full keyword strategy from a seed keyword: long-tail variations, search intent classification, semantic/LSI terms, and content gap opportunities.

Inputs

Field	Required	Description
Seed Keyword	Yes	The primary keyword or phrase you want to rank for
Niche / Industry	No	Narrows suggestions to a specific context
Target Country	No	Country for SERP results (default: US)
Number of Variations	No	Long-tail keywords to generate (5–30, default 15)

Output (structured JSON)

json

{
  "primary_keyword": "electric car charging station",
  "volume_estimate": "unknown",
  "intent": "commercial",
  "difficulty": "medium",
  "long_tail_keywords": [
    { "keyword": "best home ev charging station 2025", "intent": "commercial", "difficulty": "low", "rationale": "..." }
  ],
  "semantic_terms": [
    { "term": "EVSE", "relevance": "..." }
  ],
  "content_gaps": [
    { "angle": "Apartment-friendly EV charging", "suggested_title": "..." }
  ]
}

Tools used

fetch_serp_results — fetches top organic results to infer competition and intent

Meta Tag Generator

Slug: meta-tag-generator | Category: On-page | SERP data: No | Est. time: 20 s

Generates optimised title tags, meta descriptions, Open Graph tags, and Twitter Card tags. Accepts a URL (fetches live content) or pasted text.

Inputs

Field	Required	Description
Page URL	One of URL or Content required	Fetches live page content via HTTP
Page Content	One of URL or Content required	Paste raw copy or HTML — HTML tags are stripped
Target Keyword	No	Keyword to include in title and description
Brand Name	No	Appended to the title tag (e.g. `… \| ChargePanda`)
Number of Variations	No	How many alternative tag sets to generate (1–5, default 3)

Output (HTML)

Ready-to-copy <head> snippet for each variation, wrapped in <pre><code> blocks with a one-sentence strategic rationale.

Tools used

fetch_web_page — fetches and extracts body text from the provided URL

Competitor Analysis

Slug: competitor-analysis | Category: Research | SERP data: Yes | Est. time: 60 s

Fetches the top-ranking pages for a keyword, analyses their SEO tactics (word count, heading structure, schema, strengths/weaknesses), and produces a ranked list of recommendations to outrank them.

Inputs

Field	Required	Description
Target Keyword	Yes	Keyword to analyse competition for
Your Page URL	No	If provided, your page is included in the comparison
Target Country	No	Country for SERP results (default: US)
Competitors to Analyse	No	Number of top-ranking pages to fetch (2–5, default 3)

Output (structured JSON)

json

{
  "keyword": "best ev home charger",
  "serp_data_available": true,
  "your_score": null,
  "competitors": [
    {
      "position": 1,
      "url": "https://example.com",
      "title": "...",
      "word_count": 2800,
      "h1": "...",
      "h2_count": 8,
      "has_schema": true,
      "strengths": ["Comparison table", "Expert quotes"],
      "weaknesses": ["No installation guide"]
    }
  ],
  "content_gaps": ["Installation cost breakdown"],
  "recommendations": ["Target 2,500–3,000 words to match competitor depth"]
}

Tools used

fetch_serp_results — fetches top organic SERP results
fetch_web_page — fetches and parses each competitor page

Content Audit

Slug: content-audit | Category: On-page | SERP data: No | Est. time: 25 s

Audits an existing page for SEO health across eight dimensions. Produces an overall score (0–100), letter grade, and actionable quick wins.

Inputs

Field	Required	Description
Page URL	One of URL or Content required	Fetches live page for analysis
Page Content	One of URL or Content required	Paste full HTML or plain text
Target Keyword	No	Used to check keyword placement and density

Output (structured JSON)

json

{
  "url": "https://example.com/page",
  "overall_score": 72,
  "grade": "B",
  "target_keyword": "home EV charger",
  "readability": { "flesch_score": 65, "grade_level": 9, "reading_ease": "Standard", "word_count": 1200 },
  "dimensions": [
    { "name": "Title Tag", "score": "pass", "notes": "57 chars, keyword present" },
    { "name": "Meta Description", "score": "warn", "notes": "145 chars — slightly short" },
    { "name": "Heading Structure", "score": "fail", "notes": "Two H1 tags found" }
  ],
  "issues": ["Duplicate H1"],
  "quick_wins": ["Merge H1 tags", "Expand meta description to 155+ chars"],
  "detailed_recommendations": ["..."]
}

Dimensions scored: Title Tag, Meta Description, Heading Structure, Keyword Usage, Readability, Content Depth, Open Graph tags, Canonical tag.

Tools used

fetch_web_page — fetches and extracts page content
analyse_readability — computes Flesch reading ease and grade level

Content Brief

Slug: content-brief | Category: Content | SERP data: Yes | Est. time: 45 s

Creates a detailed brief for a content writer: recommended title, H1, word count target, heading outline, must-cover topics, secondary keywords, content formats, schema recommendation, and internal linking ideas.

Inputs

Field	Required	Description
Target Keyword	Yes	The keyword to build the brief around
Content Goal	No	Informational, commercial, landing page, product, or FAQ
Target Audience	No	Who the content is written for
Target Country	No	Country for SERP results (default: US)
Competitor URL	No	A top-ranking URL to analyse structure and depth

Output (structured JSON)

json

{
  "keyword": "ev charger installation guide",
  "recommended_title": "EV Charger Installation Guide: Costs, Steps & Top Picks (2025)",
  "recommended_h1": "EV Charger Installation Guide",
  "word_count_range": "2000–2500",
  "search_intent": "informational",
  "tone": "helpful, authoritative, jargon-light",
  "outline": [
    { "heading": "What is an EV Charger?", "level": "H2", "notes": "Brief intro — 100 words" }
  ],
  "must_include_topics": ["permitting requirements", "cost breakdown"],
  "must_include_keywords": ["Level 2 charger", "EVSE"],
  "recommended_formats": ["comparison table", "numbered steps", "FAQ section"],
  "schema_recommendation": "HowTo",
  "internal_linking_ideas": ["best home ev chargers"],
  "cta_recommendation": null
}

Tools used

fetch_serp_results — analyses what formats and topics rank for the keyword
fetch_web_page — fetches competitor URL structure when provided

Schema Markup

Slug: schema-markup | Category: On-page | SERP data: No | Est. time: 20 s

Generates valid JSON-LD schema markup ready to paste into a page's <head>. Supports Article, HowTo, FAQ, Product, LocalBusiness, BreadcrumbList, Review, Recipe, Event, VideoObject, and WebSite schemas. Can auto-detect the correct type from page content.

Inputs

Field	Required	Description
Page URL	One of URL or Content required	Fetches live page content
Page Content	One of URL or Content required	Paste content, FAQs, product details, or step-by-step instructions
Schema Type	No	Specific type or "Auto-detect" (default)
Site / Business Name	No	Used in publisher, brand, and WebSite schemas
Also generate BreadcrumbList?	No	Generates a second schema block for breadcrumb navigation

Output (HTML)

A heading for each schema block followed by a <pre><code> block containing the JSON-LD, ready to copy-paste. Any properties that could not be inferred from the content are flagged so the user knows what to fill in manually.

Supported schema types: Article, HowTo, FAQPage, Product, LocalBusiness, BreadcrumbList, Review, Recipe, Event, VideoObject, WebSite.

Tools used

fetch_web_page — fetches and parses the page when a URL is provided

Agents Reference ​

Keyword Research ​

Inputs ​

Output (structured JSON) ​

Tools used ​

Meta Tag Generator ​

Inputs ​

Output (HTML) ​

Tools used ​

Competitor Analysis ​

Inputs ​

Output (structured JSON) ​

Tools used ​

Content Audit ​

Inputs ​

Output (structured JSON) ​

Tools used ​

Content Brief ​

Inputs ​

Output (structured JSON) ​

Tools used ​

Schema Markup ​

Inputs ​

Output (HTML) ​

Tools used ​

Agents Reference

Keyword Research

Inputs

Output (structured JSON)

Tools used

Meta Tag Generator

Inputs

Output (HTML)

Tools used

Competitor Analysis

Inputs

Output (structured JSON)

Tools used

Content Audit

Inputs

Output (structured JSON)

Tools used

Content Brief

Inputs

Output (structured JSON)

Tools used

Schema Markup

Inputs

Output (HTML)

Tools used