Documentation

Changelog

Public release notes for AgentSEO. Use this page to track API behavior changes, package releases, and workflow improvements before you update production agents.

Early launch history is reconstructed from shipped API surfaces, package versions, and production release work so the public timeline stays useful even where the original notes were sparse.

2026-08-20

More reliable country targeting for SEO research

Keyword, competitor, traffic, and page research now checks country and language inputs before an analysis begins, helping your workflow use a valid market target from the start.

What Changed
  • Use supported country names, ISO codes, or location codes across keyword and domain research workflows.
  • Catch unsupported country, city-level, and language combinations before a research request runs.
  • Receive a clearer validation message so your agent can correct the target and retry with confidence.
Packages

No package release attached to this update.

2026-07-16

Backlink Opportunity Finder

AgentSEO added a deterministic workflow for turning backlink prospects and competitor link-gap exports into safe, prioritized outreach and reclaim actions.

What Changed
  • Added POST /api/v1/backlinks/opportunity-finder for supplied prospects, competitor domains, owned linkable assets, existing backlink domains, spam filters, and priority thresholds.
  • Requests cost 2 credits and do not call a paid backlink provider directly; users can reuse outputs from /backlinks/page-intersection, /backlinks/competitors, /backlinks/list, or external exports.
  • Added agent_workflow, markdown_summary, opportunity scoring, outreach angles, recommended assets, and risk flags for spam, weak relevance, paid-link risk, and missing owned assets.
  • Added the agentseo_backlinks_opportunity_finder MCP tool plus API reference and agent-readable discovery.
Packages

No package release attached to this update.

2026-07-16

ICP Workflow Bundles

AgentSEO added public workflow bundles that package existing API endpoints around the core jobs vibe marketers and SEO operators need to finish.

What Changed
  • Added /docs/workflows with launch, refresh, AI visibility, programmatic SEO safety, and competitor content gap playbooks.
  • Each bundle documents who it is for, when to use it, endpoint sequence, credit posture, success signals, and risk controls.
  • Updated docs navigation, docs landing, use cases, homepage journey, and sitemap so users find workflows before scanning individual endpoints.
  • No provider internals are exposed; customers see AgentSEO workflows and agent-ready outputs.
Packages

No package release attached to this update.

2026-07-16

AI Visibility Prompt-Set Builder

AgentSEO added a deterministic prompt-set builder for AI visibility monitoring, mapping prompts to platforms, competitors, owned assets, citations, and weekly action routing.

What Changed
  • Added POST /api/v1/ai-visibility/prompt-set for target brand, category, platforms, competitors, topics, personas, product terms, owned assets, cadence, and prompt count.
  • Requests cost 2 credits and do not run live LLM queries or call a paid search API; the workflow builds the stable measurement set and routing plan.
  • Added the agentseo_ai_visibility_prompt_set MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow separates mentions, first mention, citations, cited URLs, competitors, and mapped assets instead of flattening AI visibility into one vanity score.
Packages

No package release attached to this update.

2026-07-16

Programmatic SEO Template Planner

AgentSEO added a deterministic planning workflow for safe programmatic SEO templates, including uniqueness rules, indexation gates, internal-link architecture, schema guidance, and launch QA.

What Changed
  • Added POST /api/v1/content/programmatic-template for playbook, keyword pattern, URL pattern, data sources, variables, unique fields, sample records, competitors, and publishing cadence.
  • Requests cost 2 credits and do not call a paid search API; the workflow uses supplied template and data-model inputs.
  • Added the agentseo_content_programmatic_template MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow is intentionally conservative: weak public-data or bulk-import plans are flagged as do_not_scale_yet instead of encouraging doorway-style page generation.
Packages

No package release attached to this update.

2026-07-16

Page CRO / CTA QA

AgentSEO added a deterministic conversion-readiness workflow for SEO landing pages, checking value proposition clarity, CTA strength, trust proof, objection handling, and conversion friction.

What Changed
  • Added POST /api/v1/page/cro-qa for URL, HTML, or markdown inputs with page type, conversion goal, traffic source, audience, and target keyword context.
  • Requests cost 2 credits and do not call a paid search API; URL mode uses AgentSEO's safe page fetch path.
  • Added the agentseo_page_cro_qa MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow helps marketers turn SEO traffic into business outcomes by QAing CTAs, proof, and conversion path clarity before publishing.
Packages

No package release attached to this update.

2026-07-16

SERP Volatility Monitor

AgentSEO added a deterministic SERP volatility workflow that compares supplied snapshots to detect rank churn, top-domain churn, SERP feature changes, winners, losers, and target visibility movement.

What Changed
  • Added POST /api/v1/serp/volatility for supplied rank-tracker, Search Console-style, or AgentSEO snapshot exports.
  • Requests cost 2 credits and do not call a paid search API; the workflow analyzes supplied snapshots only.
  • Added the agentseo_serp_volatility MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow helps marketers decide whether a rank change needs page-level fixes now or monitoring because the SERP itself is moving.
Packages

No package release attached to this update.

2026-07-16

Sitemap / Orphan Page Audit

AgentSEO added a deterministic sitemap and orphan-page audit workflow for finding important URLs missing from sitemaps, sitemap-only orphan candidates, indexability noise, canonical mismatches, and internal-link gaps.

What Changed
  • Added POST /api/v1/site/sitemap-audit for supplied sitemap XML or sitemap URLs plus optional crawl, important URL, and internal-link exports.
  • Requests cost 2 credits and do not call a paid search API; URL mode safely fetches sitemap XML while XML mode works from pasted exports.
  • Added the agentseo_site_sitemap_audit MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before content expansion or migration cleanup when marketers need to make sure valuable pages are discoverable, internally linked, and not mixed with noindex/error/canonical-noise URLs.
Packages

No package release attached to this update.

2026-07-16

Competitor Content Gap Matrix

AgentSEO added a deterministic competitor gap workflow that groups missing topics, weak coverage, format gaps, and buyer-stage gaps into an execution-ready content matrix.

What Changed
  • Added POST /api/v1/content/competitor-gap-matrix for supplied competitor pages, owned pages, topic scoring, page-type-by-stage matrix output, suggested titles, next endpoints, agent_workflow, and markdown_summary.
  • Requests cost 3 credits and do not call a paid SERP provider; the workflow uses supplied competitor and owned page exports.
  • Added the agentseo_content_competitor_gap_matrix MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /domain/competitors, /domain/intersection, /pages/intersection, or external SEO exports when marketers need to turn competitor coverage into content briefs and an action plan.
Packages

No package release attached to this update.

2026-07-16

Content Cannibalization Detector

AgentSEO added a deterministic workflow for finding overlapping SEO pages and turning the findings into safe consolidation, differentiation, canonical, and internal-link actions.

What Changed
  • Added POST /api/v1/content/cannibalization for page-pair overlap scoring, shared keyword detection, preferred URL selection, conflict clusters, agent_workflow, and markdown_summary.
  • Requests cost 2 credits and do not call a paid SERP provider; the workflow uses supplied page, keyword, query, canonical, and performance signals.
  • Added the agentseo_content_cannibalization MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /content/keyword-map or Search Console exports when marketers need to decide whether to differentiate, consolidate, canonicalize, internally link, or monitor overlapping pages.
Packages

No package release attached to this update.

2026-07-16

Content Action Plan Workflow

AgentSEO added a deterministic planning workflow that turns supplied SEO opportunities into a capacity-aware content calendar and execution plan.

What Changed
  • Added POST /api/v1/content/action-plan for scheduling new content, refreshes, technical fixes, internal-link work, schema tasks, outreach, and monitoring items.
  • Requests cost 2 credits and do not call a paid SERP provider; the workflow uses supplied opportunities from AgentSEO outputs or user-provided planning data.
  • Added the agentseo_content_action_plan MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /opportunities/find, /content/keyword-map, /content/technical-qa, /domain/intersection, or /pages/intersection when marketers need a 30-day action plan instead of another report.
Packages

No package release attached to this update.

2026-07-16

Technical Publish QA Workflow

AgentSEO added a deterministic pre-publish SEO QA workflow for checking whether a URL, HTML page, or markdown draft is technically safe to publish.

What Changed
  • Added POST /api/v1/content/technical-qa for indexability, metadata, canonical, heading, structured-data, internal-link, image-alt, readiness-score, agent_workflow, and markdown_summary checks.
  • Requests cost 2 credits and do not call a paid SERP provider; URL mode uses AgentSEO's safe fetch path, while HTML/Markdown mode works before a page is live.
  • Added the agentseo_content_technical_qa MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /content/title-meta, /content/schema-plan, and /content/internal-links when marketers need a final publish gate.
Packages

No package release attached to this update.

2026-07-16

Page Intersection Workflow

AgentSEO added a paid-data workflow for comparing ranking pages and turning shared or competitor-exclusive page keywords into content actions.

What Changed
  • Added POST /api/v1/pages/intersection for page-level keyword overlap, rank spread, traffic gap, intent, SERP features, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested keywords, minimum 5. Optional clickstream enrichment doubles the credit cost because it doubles paid-data cost.
  • Added the agentseo_page_intersection MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /domain/intersection or /domain/relevant-pages when marketers need exact page-level keyword gaps before refresh briefs.
Packages

No package release attached to this update.

2026-07-16

Backlinks Page Intersection Workflow

AgentSEO added a paid-data workflow for finding source pages that link to competitor targets but not excluded/user targets, then turning them into link-gap outreach actions.

What Changed
  • Added POST /api/v1/backlinks/page-intersection for source URL, source domain, rank, domain rank, spam score, linked competitor targets, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested source pages, minimum 5, with target, exclude-target, intersection-mode, authority, spam, dofollow, broken-link, and sort controls.
  • Added the agentseo_backlinks_page_intersection MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/competitors when marketers need exact link-gap source pages before outreach or linkable-asset work.
Packages

No package release attached to this update.

2026-07-16

Backlinks New/Lost Timeseries Workflow

AgentSEO added a paid-data workflow for tracking backlink gains and losses over time and turning link velocity into momentum, leakage, and volatility actions.

What Changed
  • Added POST /api/v1/backlinks/new-lost-timeseries for new/lost backlinks, referring-domain movement, net change, loss rate, strongest gain/loss periods, agent_workflow, and markdown_summary.
  • Requests cost 5 credits and use one paid backlink movement request with optional date range, grouping, and subdomain controls.
  • Added the agentseo_backlinks_new_lost_timeseries MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary when marketers need to decide whether link authority is growing, leaking, volatile, or stable.
Packages

No package release attached to this update.

2026-07-16

Backlinks Competitors Workflow

AgentSEO added a paid-data workflow for discovering backlink-profile competitors and turning overlap into link-gap research actions.

What Changed
  • Added POST /api/v1/backlinks/competitors for competitor domain, authority rank, backlink intersections, overlap score, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested competitors, minimum 5, with optional rank and intersection filters.
  • Added the agentseo_backlinks_competitors MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary when marketers need to identify realistic link-gap competitors before inspecting exact source URLs.
Packages

No package release attached to this update.

2026-07-16

Backlinks Domain Pages Workflow

AgentSEO added a paid-data workflow for finding backlink-bearing pages and turning them into linkable asset, repair, reclaim, refresh, and quality-review actions.

What Changed
  • Added POST /api/v1/backlinks/domain-pages for page URL, title, status code, word count, backlink counts, referring domains, broken-link signals, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested pages, minimum 5, with compact internal arrays and optional page, title, status, backlink, referring-domain, and word-count filters.
  • Added the agentseo_backlinks_domain_pages MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary when marketers need to identify which pages already attract links and should be protected, repaired, refreshed, or repeated.
Packages

No package release attached to this update.

2026-07-15

Backlinks Referring Domains Workflow

AgentSEO added a paid-data workflow for analyzing referring domains and turning link sources into authority protection, recovery, repair, quality-review, and outreach actions.

What Changed
  • Added POST /api/v1/backlinks/referring-domains for linking-domain rank, backlink counts, referring pages, spam and broken-link signals, platform/country distributions, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested referring domains, minimum 5, with compact internal arrays and optional domain, backlink, referring-page, and rank filters.
  • Added the agentseo_backlinks_referring_domains MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary and before /backlinks/list when marketers need to decide which linking domains deserve exact source inspection.
Packages

No package release attached to this update.

2026-07-15

Backlinks Anchors Workflow

AgentSEO added a paid-data workflow for analyzing backlink anchor text patterns and turning them into brand, commercial, repair, reclaim, and quality-review actions.

What Changed
  • Added POST /api/v1/backlinks/anchors for anchor groups, backlink counts, referring domains, spam and broken-link signals, intent classification, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested anchor groups, minimum 5, with compact internal arrays and optional anchor, backlink, and referring-domain filters.
  • Added the agentseo_backlinks_anchors MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary and before /backlinks/list when marketers need to decide which anchor patterns deserve exact source inspection.
Packages

No package release attached to this update.

2026-07-15

Backlinks List Workflow

AgentSEO added a paid-data workflow for turning detailed backlink examples into protect, repair, reclaim, quality-review, and outreach-reference actions.

What Changed
  • Added POST /api/v1/backlinks/list for bounded backlink lists with source URL, target URL, anchor, rank, status, action type, priority, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested backlinks, minimum 5, and default to one backlink per referring domain to reduce duplicate noise.
  • Added the agentseo_backlinks_list MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /backlinks/summary when marketers need the actual links to protect, repair, reclaim, review, or use as outreach references.
Packages

No package release attached to this update.

2026-07-15

Backlinks Summary Workflow

AgentSEO added a paid-data workflow for summarizing backlink authority, spam risk, broken links, and referring-domain signals before deeper SEO planning.

What Changed
  • Added POST /api/v1/backlinks/summary for backlink counts, referring domains, rank, spam risk, broken backlink signals, top link distributions, recommended action type, agent_workflow, and markdown_summary.
  • Requests cost 5 credits and use one paid backlinks-summary request with compact internal arrays.
  • Added the agentseo_backlinks_summary MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fills the authority and link-risk layer before /domain/traffic-estimate, /domain/ranked-keywords, /domain/relevant-pages, and /domain/competitors.
Packages

No package release attached to this update.

2026-07-15

Domain Traffic Estimate Workflow

AgentSEO added a paid-data workflow for comparing estimated search traffic across multiple domains, subdomains, or URLs before deeper competitor analysis.

What Changed
  • Added POST /api/v1/domain/traffic-estimate for organic, paid, featured-snippet, and local-pack traffic estimates, footprint type, opportunity score, recommended action type, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 25 supplied targets, minimum 5, and use one paid bulk traffic-estimation request.
  • Added the agentseo_domain_traffic_estimate MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before /domain/competitors, /domain/ranked-keywords, /domain/relevant-pages, and /domain/intersection when marketers need to choose which domains deserve deeper analysis credits.
Packages

No package release attached to this update.

2026-07-15

Domain Intersection Workflow

AgentSEO added a paid-data workflow for comparing two domains and turning shared keyword deficits, advantages, and target1-exclusive keywords into agent-ready actions.

What Changed
  • Added POST /api/v1/domain/intersection for shared keyword comparison, rank gaps, traffic gaps, opportunity score, recommended action type, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested keywords, minimum 5, and use one paid intersection request with clickstream and extra SERP enrichment disabled.
  • Added the agentseo_domain_intersection MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /domain/competitors when marketers choose a competitor and need keyword-level refresh, protection, or expansion actions.
Packages

No package release attached to this update.

2026-07-15

Domain Competitors Workflow

AgentSEO added a paid-data workflow for discovering search competitors and turning overlap metrics into prioritized next analysis actions.

What Changed
  • Added POST /api/v1/domain/competitors for competitor domains, shared keywords, traffic gaps, threat level, recommended action type, opportunity score, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested competitors, minimum 5, and use one paid competitor-domain request with clickstream enrichment disabled.
  • Added the agentseo_domain_competitors MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before /domain/ranked-keywords and /domain/relevant-pages when marketers need to decide which competitors deserve deeper keyword and page-level analysis.
Packages

No package release attached to this update.

2026-07-15

Domain Relevant Pages Workflow

AgentSEO added a paid-data workflow for finding the pages on a domain that carry organic traffic and turning them into protect, refresh, expand, or recover actions.

What Changed
  • Added POST /api/v1/domain/relevant-pages for page-level organic traffic, keyword counts, top-position buckets, movement signals, recommended action type, opportunity score, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested pages, minimum 5, and use one paid relevant-pages request with clickstream enrichment disabled.
  • Added the agentseo_domain_relevant_pages MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /domain/ranked-keywords and before /content/refresh-brief when marketers need to choose which URLs deserve protection, expansion, recovery, or refresh work.
Packages

No package release attached to this update.

2026-07-15

Domain Ranked Keywords Workflow

AgentSEO added a paid-data workflow for finding a domain, subdomain, or page URL's ranked keywords and turning them into refresh priorities.

What Changed
  • Added POST /api/v1/domain/ranked-keywords for ranked keyword rows, ranking page URLs, movement, search metrics, SERP features, opportunity type, opportunity score, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 100 requested rows, minimum 5, and use one paid ranked-keywords request with clickstream enrichment disabled.
  • Added the agentseo_domain_ranked_keywords MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before /content/refresh-brief, /content/keyword-map, and /rank/track when marketers need to inspect existing keyword traction.
Packages

No package release attached to this update.

2026-07-15

Keyword Metrics Overview Workflow

AgentSEO added a paid-data keyword metrics workflow for scoring supplied keyword lists before page mapping and briefing.

What Changed
  • Added POST /api/v1/keyword-metrics/overview for search volume, CPC, competition, difficulty, buyer stage, page-type guidance, opportunity scores, agent_workflow, and markdown_summary.
  • Requests cost 5 credits per 25 keywords, minimum 5, and use one paid keyword overview request with SERP and clickstream enrichment disabled.
  • Added the agentseo_keyword_metrics_overview MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits after /keyword-ideas/suggest or external keyword imports, before /keyword-cluster/build and /content/keyword-map.
Packages

No package release attached to this update.

2026-07-15

Keyword Ideas Suggest Workflow

AgentSEO added a paid-data keyword expansion workflow for turning one seed topic into prioritized long-tail content ideas.

What Changed
  • Added POST /api/v1/keyword-ideas/suggest for expanding a seed keyword into prioritized ideas with volume, CPC, competition, buyer stage, recommended page type, agent_workflow, and markdown_summary.
  • Requests cost 4 credits and use one paid keyword suggestions request with SERP enrichment disabled by default.
  • Added the agentseo_keyword_ideas_suggest MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before /keyword-cluster/build and /content/keyword-map so marketers can validate ideas before drafting pages.
Packages

No package release attached to this update.

2026-07-15

Keyword-to-Page Map Workflow

AgentSEO added a deterministic keyword mapping workflow for assigning keywords to existing pages before agents create duplicate content.

What Changed
  • Added POST /api/v1/content/keyword-map for mapping supplied keywords to supplied pages, flagging weak matches, missing pages, and cannibalization risks.
  • Requests cost 2 credits and do not call the paid search-data provider; the workflow uses supplied keywords and page metadata to return agent_workflow plus markdown_summary.
  • Added the agentseo_content_keyword_map MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow fits before /content/brief, /content/internal-links, and /content/title-meta so agents know which page each intent should target.
Packages

No package release attached to this update.

2026-07-15

Title & Meta Optimization Workflow

AgentSEO added a deterministic metadata workflow for preparing search title and meta description options before publishing.

What Changed
  • Added POST /api/v1/content/title-meta for generating title options, meta description options, current signal checks, snippet risks, implementation checklist, agent_workflow, and markdown_summary.
  • Requests cost 2 credits and do not call the paid search-data provider; URL mode performs one source-page scrape, while markdown mode is fully deterministic.
  • Added the agentseo_content_title_meta MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow complements /content/draft-qa, /content/schema-plan, and /content/internal-links in the pre-publish sequence.
Packages

No package release attached to this update.

2026-07-15

Internal Link Opportunities Workflow

AgentSEO added a deterministic internal-link planning workflow for turning a source page and candidate target pages into publish-ready link placements.

What Changed
  • Added POST /api/v1/content/internal-links for ranking supplied target pages, suggesting natural anchor text, source-section placement, crawlability guardrails, review notes, agent_workflow, and markdown_summary.
  • Requests cost 2 credits and do not call the paid search-data provider; URL mode performs one source-page scrape, while markdown mode is fully deterministic.
  • Added the agentseo_content_internal_links MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow complements /content/draft-qa and /content/schema-plan by helping teams strengthen page architecture before publishing.
Packages

No package release attached to this update.

2026-07-15

Schema Plan Workflow for Publish Readiness

AgentSEO added a deterministic schema planning workflow for generating JSON-LD guidance without a paid SERP provider call.

What Changed
  • Added POST /api/v1/content/schema-plan for recommending schema types, JSON-LD drafts, required field checklists, missing page evidence, FAQ candidates, validation steps, agent_workflow, and markdown_summary.
  • Requests cost 3 credits and do not call the paid search-data provider; URL mode performs one page scrape, while markdown mode is fully deterministic.
  • Added the agentseo_content_schema_plan MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow complements /content/draft-qa by helping teams prepare structured data before publishing.
Packages

No package release attached to this update.

2026-07-15

Content Draft QA Before Publishing

AgentSEO added a pre-publish QA workflow that checks draft URLs or markdown against live SERP expectations.

What Changed
  • Added POST /api/v1/content/draft-qa for validating drafts before publishing with publish_readiness_score, missing SERP expectations, weak sections, proof gaps, title/meta issues, editor tasks, agent_workflow, and markdown_summary.
  • Requests cost 8 credits and use one live organic SERP task at default depth, plus one draft page scrape when draft_url is provided.
  • Added the agentseo_content_draft_qa MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • This closes the loop after /content/brief by helping writers and coding agents fix weak drafts before they go live.
Packages

No package release attached to this update.

2026-07-15

Content Brief Workflow for SERP-Led Drafting

AgentSEO added a production-ready content brief workflow for turning live SERP intent into writer- and agent-ready page instructions.

What Changed
  • Added POST /api/v1/content/brief for creating content briefs with audience, meta, SERP expectations, competitor patterns, differentiators, proof requirements, conversion plan, QA checklist, agent_workflow, and markdown_summary.
  • Requests cost 6 credits and use one live organic SERP task at default depth to keep provider spend predictable.
  • Added the agentseo_content_brief MCP tool plus playground, API reference, OpenAPI, and use-case documentation.
  • The workflow complements /content/serp-outline: use the outline for structure, and /content/brief when a writer or coding agent needs a fuller production brief.
Packages

No package release attached to this update.

2026-07-15

SERP Outline Workflow for Page Creation

AgentSEO added a low-cost content planning workflow that turns live SERP intent into writer- and agent-ready outlines.

What Changed
  • Added POST /api/v1/content/serp-outline for building page outlines from live SERP competitors, features, intent, and validation checks.
  • The workflow returns outline, serp_opportunity, agent_workflow, schema recommendations, internal-link ideas, and markdown_summary.
  • Requests cost 4 credits and reuse the same credit-safe job queue and public job-status contract as the opportunity workflows.
  • Updated the API reference, playground, MCP tool registry, and agent-readable discovery surfaces for the new workflow.
Packages

No package release attached to this update.

2026-07-14

Credit-Safe Opportunity Workflows for Vibe Marketers

AgentSEO added a safer opportunity-to-refresh workflow layer for marketers and coding agents, with atomic credit accounting, private implementation details, and richer implementation briefs.

What Changed
  • Added POST /api/v1/opportunities/find to turn ranked keywords and competitor context into prioritized SEO opportunities with evidence, recommended actions, next calls, and markdown summaries.
  • Added POST /api/v1/opportunities/brief to convert one selected keyword or page opportunity into an implementation-ready brief for Claude Code, writers, or internal content teams.
  • Added POST /api/v1/content/refresh-brief to turn an existing URL and keyword into a refresh plan with missing sections, title/H1 guidance, schema recommendations, validation checks, and agent_workflow output.
  • Introduced a credit ledger and atomic enqueue path so paid and free users are charged before paid analysis work starts, with idempotent retries protected from double charging.
  • Sanitized completed public job payloads so implementation internals stay private while customer-facing SEO evidence remains available.
  • Updated API reference, use cases, playground, pricing notes, OpenAPI, and agent-readable docs for the new marketer workflow surface.
Packages

No package release attached to this update.

2026-05-04

Original Proof Blocks, Audience Paths, and Stronger Blog SEO

AgentSEO strengthened the blog as a conversion and authority surface with original-information blocks, guided audience paths, pattern interrupts, and tighter metadata and structured data.

What Changed
  • Added original-information proof blocks across core blog posts so articles carry more proprietary examples, prompts, screenshots, and workflow evidence.
  • Introduced pattern interrupts inside long-form posts to make dense technical content easier to scan and act on.
  • Added dedicated audience path pages and guided read-next flows so developers, marketers, and builder-marketers can move through the right content sequence.
  • Improved the blog code block copy experience for implementation-heavy posts.
  • Highlighted original information across blog surfaces and updated editorial guidance with a documented original-information program.
  • Tightened SEO metadata snippets and strengthened structured data across public marketing, blog, author, pricing, and topic pages.
Packages

No package release attached to this update.

2026-05-03

Agent-Readable Site Surfaces and Blog Topic Hubs

AgentSEO expanded its content engine with topic hubs, a large AI-search and Claude Code blog cluster, and new agent-readable discovery routes for crawlers, LLMs, and MCP-aware clients.

What Changed
  • Added /.well-known agent, MCP, API catalog, and skill routes so automated clients can discover AgentSEO capabilities more directly.
  • Added llms.txt, llms-full.txt, openapi.yaml, and agent-md routes for LLM-friendly site and documentation consumption.
  • Launched blog topic hub pages with discovery paths from the blog index and related article surfaces.
  • Published new AI search, Claude Code, MCP decision, marketer workflow, builder-marketer, and AI visibility operations blog clusters.
  • Added proof visuals and product screenshots for workflow posts, including async flow, runtime modes, Claude Code triage, and n8n workflow examples.
  • Surfaced the Claude Code integration path from the homepage, docs use cases, integration pages, and related blog clusters.
Packages

No package release attached to this update.

2026-04-29

Blog Readability, Sticky Article Navigation, and Editorial Guidelines

The AgentSEO blog experience was tightened for longer technical articles, with cleaner reading flow, more useful article navigation, and a documented editorial standard for future posts.

What Changed
  • Made the article-side rail sticky so table-of-contents navigation and conversion prompts remain accessible while readers move through long posts.
  • Polished the blog CTA layout to better fit article context and reduce visual friction around the end-of-post conversion path.
  • Improved article readability with tighter layout spacing, calmer metadata treatment, and simpler table-of-contents behavior.
  • Refined the blog index, author card, and article template presentation so the blog feels more consistent with the rest of the product site.
  • Added blog editorial guidelines covering structure, source quality, formatting, and review expectations for future AgentSEO content.
Packages

No package release attached to this update.

2026-04-23

Public Blog Launch, Auth Hardening, and Site Theme Stabilization

AgentSEO launched its public blog and author profile surface, then followed up with tighter auth checks and a sitewide dark-theme fix.

What Changed
  • Launched /blog, individual article pages, /authors, and author profile pages backed by structured blog and author content.
  • Added article CTAs, author cards, table-of-contents support, breadcrumb JSON-LD, and sitemap coverage for blog and author routes.
  • Forced the public site back to the intended dark theme after launch so marketing, docs, dashboard, and blog pages render consistently.
  • Tightened auth and verification handling around user profile routes and middleware-protected paths.
  • Updated staging smoke coverage to verify auth-adjacent behavior as part of release validation.
Packages

No package release attached to this update.

2026-03-03

Integration Pages, Copyable Setup Blocks, and Social-Traffic CRO

AgentSEO added a dedicated integrations hub and spoke pages for the strongest current integration paths, then tightened those pages for higher-intent traffic coming from social comments and community replies.

What Changed
  • Launched a new /integrations hub plus dedicated pages for n8n, Make, Claude Code, Claude Desktop, and OpenClaw.
  • Positioned each integration page conservatively by actual integration type, including HTTP workflow, local MCP, hosted or local MCP, and first-party AgentSEO plugin language where appropriate.
  • Added copyable setup and example blocks so visitors can move from landing page to implementation without hunting through docs.
  • Added workflow examples, visual flow diagrams, FAQ schema, breadcrumb schema, and HowTo schema across the spoke pages.
  • Reworked hero and CTA language for colder social traffic, with faster-fit messaging, same-page setup jumps, and lighter motion to improve scanability and action-taking.
Packages

No package release attached to this update.

2026-03-01

Production Reliability, Async Contract Cleanup, and Rich-Style Validation

Production async flows were hardened, queued endpoints were normalized for agents, and the full Rich-style local SEO workflow set was replayed successfully in production.

What Changed
  • Normalized queued 202 responses across local visibility, LLM mentions, content decay, and keyword clustering to return poll_url, events_url, and retry_after_seconds.
  • Improved SERP data degradation handling with clearer retryable error classification, longer transient polling windows, and safer fallback behavior during data-source instability.
  • Switched canonical outbound language targeting toward language_code handling and refreshed stale geo resolution behavior.
  • Validated production end to end with Rich-style workflows across search, local audit, local visibility, SERP analysis, and content gap.
  • Cleaned up the public API surface so agent builders can rely on a more consistent async contract.
Packages
  • @agentseo/openclaw-plugin@0.1.4
  • @agentseo/acp-adapter@0.1.2
  • @agentseo/sdk@0.1.1

2026-02-28

Agent Workflow Responses and Safer External Fetching

Core workflow responses became more agent-native, while external fetch and webhook paths were hardened for production use.

What Changed
  • Core workflows now return agent_workflow with decision, confidence, evidence, recommended actions, limitations, and next_calls.
  • Supporting primitives return agent_support or serp_opportunity instead of only raw API-shaped output.
  • External fetches now enforce bounded reads and stricter dependency handling for extract and related workflows.
  • Outgoing webhooks gained retry scheduling with backoff instead of failing terminally on the first bad attempt.
  • Hosted MCP browser access and production secret validation were tightened ahead of launch.
Packages

No package release attached to this update.

2026-02-24

New Workflow Surface for AI Overview, Local Visibility, and Monitoring

AgentSEO expanded beyond the initial core workflows with new monitoring and generative-search endpoints.

What Changed
  • Introduced POST /api/v1/ai-overview/extract.
  • Introduced POST /api/v1/local-visibility/track.
  • Introduced POST /api/v1/llm-mentions/track, /content-decay/detect, and /keyword-cluster/build.
  • Extended the docs and API reference to cover the new async workflow surface.
Packages

No package release attached to this update.

2026-02-20

Webhook Management and Job Streaming

AgentSEO added first-party webhook management and a cleaner async job model for agents and integrations.

What Changed
  • Added webhook endpoint management with create, list, update, delete, and delivery inspection routes.
  • Added webhook delivery retry support without rerunning the underlying job.
  • Added /api/v1/jobs/{id} and /api/v1/jobs/{id}/events for polling and SSE-based progress tracking.
  • Improved request attribution with project and workflow metadata carried through async jobs.
Packages

No package release attached to this update.

2026-02-18

SDK and Integration Packaging

The first public package layer shipped for JavaScript, Python, OpenClaw, and ACP integration paths.

What Changed
  • Published the official JavaScript SDK for Node-based agent and backend usage.
  • Published the official Python SDK for scripting, automation, and backend workers.
  • Published the OpenClaw plugin and ACP adapter to make AgentSEO easier to wire into agent runtimes.
  • Aligned docs and quickstarts around copy-paste install paths for common integration modes.
Packages
  • @agentseo/sdk@0.1.1
  • agentseo-sdk@0.1.0
  • @agentseo/openclaw-plugin@0.1.4
  • @agentseo/acp-adapter@0.1.2

2026-02-17

Public Launch

AgentSEO launched publicly with the first production-ready agent SEO workflow set and reference docs.

What Changed
  • Launched the initial public /api/v1 surface for search, extract, analyze/serp, content/gap, audit/local, and rank/track.
  • Shipped async-first workflow behavior with sync windows for fast paths where inline completion is realistic.
  • Published the docs hub, quickstart, API reference, and changelog pages.
  • Released the first launch-ready docs and agent integration paths for early builders.
Packages

No package release attached to this update.

Upgrade safely

Start with the quickstart for package install paths, then check API-specific parameter changes in the reference.