AgentSEO

dev.agentseo.wwwPublished by www.agentseo.devOfficial publisherv0.1.6Updated Nov 6, 2026

Live SEO workflow tools for Claude Code, Codex, and AI agents.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

AgentSEO gives an AI assistant live SEO intelligence tools: Google search, SERP analysis, keyword, backlink and content planning workflows.

What you can do
  • Search the web and extract page content as Markdown, with SERP and competitor analysis
  • Research keywords, domain rankings, traffic estimates, competitors and content gaps
  • Audit backlinks: summaries, lists, anchors, referring domains, new/lost trends and link-gap opportunities
  • Plan and QA content: briefs, outlines, drafts, titles and meta, schema, internal links, keyword maps and cannibalization checks
  • Audit sites and pages: sitemap coverage, technical pre-publish QA, landing-page conversion QA, programmatic templates and action plans
  • Build AI visibility prompt sets and audit Google Maps business listings
When to use it
Useful for SEO and content teams or developers who want an agent to run keyword, backlink, SERP and content-planning research and produce implementation-ready briefs without leaving the chat.
Requirements
A remote endpoint or the npm package @agentseo/mcp-server run locally with Node.js. Requires an AgentSEO API key, passed as the AGENTSEO_API_KEY environment variable or the x-api-key header; optional AGENTSEO_PROJECT_ID and AGENTSEO_WORKFLOW_ID attribution headers and an optional AGENTSEO_API_URL base URL. Network access to the AgentSEO API.
Before you install
The API key is a server-side secret and should not be committed or shared. The hosted API handles billing and provider calls, so tool use may consume paid credits; one tool is described as a way to compare traffic estimates before spending deeper analysis credits. Requests send your queries, domains and supplied page content to AgentSEO's servers.

Installation

In SourceWeft

  1. Open AgentSEO in the dashboard and add it to a workspace.
  2. Connect Custom headers credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dev.agentseo.www%2Fagentseo-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "agentseo": {
      "type": "http",
      "url": "https://www.agentseo.dev/mcp",
      "headers": {
        "x-api-key": "<VALUE>",
        "x-project-id": "<VALUE>",
        "x-workflow-id": "<VALUE>"
      }
    }
  }
}

README

AgentSEO Clients

Official open-source clients for AgentSEO, the SEO intelligence API for AI agents and developer workflows.

This repository contains the integration layer only:

  • packages/js-sdk - JavaScript/TypeScript SDK
  • packages/python-sdk - Python SDK
  • packages/mcp-server - Model Context Protocol server

The hosted AgentSEO API, worker system, provider orchestration, billing, and transformation logic are not part of this repository.

Quick Start

Use the JavaScript SDK:

bash
npm install @agentseo/sdk
ts
import { AgentSEO } from "@agentseo/sdk";
const client = new AgentSEO({  apiKey: process.env.AGENTSEO_API_KEY!,});
const result = await client.search(  { query: "seo api", location: "United States", limit: 5 },  { sync: true },);
console.log(result);

Use the Python SDK:

bash
pip install agentseo-sdk
python
from agentseo_sdk import AgentSEOClient
client = AgentSEOClient(api_key="sk_live_...")result = client.search(query="seo api", sync=True)print(result)

Use the MCP server:

bash
export AGENTSEO_API_KEY="sk_live_your_key"npx -y @agentseo/mcp-server

Development

Build the JavaScript SDK:

bash
cd packages/js-sdknpm installnpm run build

Build the MCP server:

bash
cd packages/mcp-servernpm installnpm run build

Install the Python SDK locally:

bash
cd packages/python-sdkpython -m pip install -e .

Security

Do not commit API keys, .env files, customer payloads, or provider credentials. See SECURITY.md.

License

MIT. See package-level LICENSE files.

Source: README.md at commit 59dfd02

Tools

45

agentseo_extract

AgentSEO Extract

Extract content from a URL and convert to Markdown.

Parametersurlrequiredinclude_images

agentseo_analyze_serp

AgentSEO Analyze SERP

Deep analysis of Search Engine Results Page (SERP) features and competitors.

Parameterssyncdevicekeywordrequiredlanguagelocation

agentseo_local_audit

AgentSEO Local Audit

Audit one Google Maps business listing. Provide its business name and city/state/country; do not pass a website URL or domain.

Parameterssynclanguagelocationrequiredbusiness_namerequired

agentseo_content_gap

AgentSEO Content Gap

Run content gap analysis for a URL and keyword.

Parametersurlrequiredsynckeywordrequiredlanguagelocationscrape_depth

agentseo_opportunities_find

AgentSEO Opportunity Finder

Find prioritized SEO opportunities for a domain or URL.

Parameterssynctargetrequiredlanguagelocationkeyword_limitopportunity_limitinclude_serp_competitorsinclude_competitor_discovery

agentseo_opportunities_brief

AgentSEO Opportunity Brief

Turn one keyword or page opportunity into an implementation-ready brief.

Parameterssynctargetrequiredkeywordrequiredlanguagelocationpage_urlcurrent_rankopportunity_typeinclude_competitor_outlines

agentseo_content_refresh_brief

AgentSEO Content Refresh Brief

Create a refresh brief for an existing URL and keyword.

Parametersurlrequiredsynckeywordrequiredlanguagelocationscrape_depth

agentseo_content_serp_outline

AgentSEO SERP Outline

Turn live SERP intent into a writer- and agent-ready page outline.

Parameterssyncdevicetargetkeywordrequiredlanguagelocationoutline_depthinclude_title_options

agentseo_content_brief

AgentSEO Content Brief

Turn live SERP intent into a production-ready content brief for writers and coding agents.

Parameterssyncdevicetargetkeywordrequiredaudiencelanguagelocationpage_typebrand_voicebrief_depthinclude_serp_outline

agentseo_content_draft_qa

AgentSEO Content Draft QA

Validate a draft URL or markdown against live SERP expectations before publishing.

Parameterssyncdevicetargetkeywordrequiredlanguagelocationqa_depthdraft_urldraft_markdown

agentseo_content_schema_plan

AgentSEO Content Schema Plan

Plan JSON-LD schema for a URL or markdown page without a provider call.

Parametersurlsynctargetkeywordpage_typepage_markdowninclude_jsonld

agentseo_content_internal_links

AgentSEO Content Internal Links

Find internal link opportunities from a source page to required supplied target pages.

Parameterssynctargetkeywordsource_urltarget_pagesmax_suggestionssource_markdown

agentseo_content_title_meta

AgentSEO Content Title Meta

Generate SEO title and meta description options for a URL or markdown page.

Parametersurlsynctargetkeywordrequiredpage_typecurrent_titlepage_markdowncurrent_meta_description

agentseo_content_keyword_map

AgentSEO Content Keyword Map

Map supplied keywords to supplied pages and flag missing pages or cannibalization risks.

Parameterssyncpagesrequiredtargetkeywordsrequiredmax_mappings

agentseo_content_technical_qa

AgentSEO Content Technical QA

Run pre-publish SEO QA for metadata, indexability, canonical, headings, schema, links, and media.

Parametersurlhtmlsynctargetkeywordmarkdownpage_typeexpected_canonicalcheck_external_links

agentseo_content_action_plan

AgentSEO Content Action Plan

Turn supplied SEO opportunities into a capacity-aware content calendar and execution plan.

Parametersgoalsyncteamitemsrequiredtargetstart_datehorizon_daysweekly_capacity

agentseo_site_sitemap_audit

AgentSEO Sitemap Audit

Audit sitemap coverage, orphan-page candidates, important URLs, canonical/indexability noise, and internal-link gaps.

Parameterssynctargetcrawl_urlssitemap_urlsitemap_xmlimportant_urlsinternal_linksmax_sitemap_children

agentseo_serp_volatility

AgentSEO SERP Volatility Monitor

Compare supplied SERP snapshots to detect rank churn, top-domain churn, feature changes, and target visibility movement.

Parameterssyncdevicetargetkeywordrequiredlocationsnapshotsrequiredsensitivitytarget_domains

agentseo_page_cro_qa

AgentSEO Page CRO QA

Audit SEO landing pages for value proposition clarity, CTA strength, trust proof, objection handling, and conversion friction.

Parametersurlhtmlsynctargetkeywordaudiencemarkdownpage_typetraffic_sourceconversion_goal

agentseo_ai_visibility_prompt_set

AgentSEO AI Visibility Prompt Set

Build stable AI visibility prompt sets mapped to owned assets, platforms, competitors, citations, and weekly action routing.

Parameterssynclocaletargetrequiredtopicsrequiredcadenceaudiencecategoryrequiredpersonasplatformscompetitorsowned_assetsprompt_count+3 more

agentseo_content_programmatic_template

AgentSEO Programmatic SEO Template

Plan safe programmatic SEO templates with uniqueness rules, indexation gates, internal links, schema guidance, and launch QA.

Parameterssynctargetaudienceplaybookpage_goalvariablesrequiredcompetitorsurl_patternrequireddata_sourcesrequiredunique_fieldsconversion_ctainclude_schema+5 more

agentseo_content_cannibalization

AgentSEO Content Cannibalization

Detect overlapping SEO pages and recommend safe consolidation, differentiation, canonical, and internal-link fixes.

Parameterssyncpagesrequiredtargetsensitivityfocus_keywords

agentseo_content_competitor_gap_matrix

AgentSEO Competitor Content Gap Matrix

Compare supplied own and competitor pages to find missing topics, weak coverage, format gaps, and buyer-stage gaps.

Parameterssynctargetown_pagescompetitorsrequiredfocus_topicsmax_opportunities

agentseo_keyword_ideas_suggest

AgentSEO Keyword Ideas Suggest

Expand one seed keyword into prioritized long-tail keyword ideas with search metrics.

Parameterssynclimitkeywordrequiredlanguagelocationexact_matchlocation_codeignore_synonymsmin_search_volumeinclude_seed_keyword

agentseo_keyword_metrics_overview

AgentSEO Keyword Metrics Overview

Score a supplied keyword list with search metrics and page-priority guidance.

Parameterssyncsort_bykeywordsrequiredlanguagelocationlocation_codemin_search_volume

agentseo_domain_ranked_keywords

AgentSEO Domain Ranked Keywords

Find ranked keywords for a domain, subdomain, or URL and prioritize refresh opportunities.

Parameterssynclimittargetrequiredsort_bylanguagelocationmax_rankinclude_lostlocation_codemin_search_volume

agentseo_domain_relevant_pages

AgentSEO Domain Relevant Pages

Find traffic-carrying pages for a domain and route them into protect, refresh, expand, or recover actions.

Parameterssynclimittargetrequiredsort_bylanguagelocationmin_trafficlocation_codehistorical_serp_mode

agentseo_domain_competitors

AgentSEO Domain Competitors

Discover search competitors for a domain and prioritize overlap, traffic gaps, and next analysis actions.

Parameterssynclimittargetrequiredsort_bylanguagelocationlocation_codemax_rank_groupmin_intersections

agentseo_domain_intersection

AgentSEO Domain Intersection

Compare two domains to find shared keyword deficits, advantages, and target1-exclusive keyword opportunities.

Parameterssynclimitsort_bytarget1requiredtarget2requiredlanguagelocationintersectionslocation_codemin_search_volume

agentseo_domain_traffic_estimate

AgentSEO Domain Traffic Estimate

Compare estimated search traffic across multiple domains, subdomains, or URLs before spending deeper analysis credits.

Parameterssyncsort_bytargetsrequiredlanguagelocationinclude_paidlocation_codeinclude_local_packinclude_featured_snippet

agentseo_backlinks_page_intersection

AgentSEO Backlinks Page Intersection

Find source pages that link to competitor targets but not excluded/user targets, then prioritize link-gap outreach and quality review.

Parameterssynclimitoffsetsort_bytargetsrequiredmin_rankrank_scalebroken_onlydofollow_onlymin_page_rankmax_spam_scoreexclude_targets+6 more

agentseo_page_intersection

AgentSEO Page Intersection

Compare ranking pages to find shared page keywords or competitor-page keywords excluded from your pages.

Parameterssynclimitpagesrequiredoffsetsort_bylanguagelocationmax_rankitem_typesexclude_pageslocation_codeignore_synonyms+5 more

agentseo_ai_overview_extract

AgentSEO AI Overview Extract

Extract AI Overview insights for a target keyword.

Parameterssynckeywordrequiredlanguagelocationtarget_domain

agentseo_local_visibility_track

AgentSEO Local Visibility Track

Track local visibility for a domain across keywords and locations.

Parameterssyncdomainrequiredkeywordsrequiredlanguagelocationsrequired

agentseo_rank_track

AgentSEO Rank Track

Queue a rank tracking check for a URL and keyword.

Parametersurlrequiredsynckeywordrequiredlocation

agentseo_job_status

AgentSEO Job Status

Get status/result for a previously queued job.

Parametersjob_idrequired

Version history

3
  1. v0.1.6LatestNov 6, 2026
  2. v0.1.5Nov 4, 2026
  3. v0.1.4Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts