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-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 DataForSEO degradation handling with clearer retryable error classification, longer transient polling windows, and safer fallback behavior during provider 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 provider-shaped output.
  • External fetches now enforce bounded reads and stricter upstream 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.