AgentSEO

dev.agentseo.www由 www.agentseo.dev 发布官方发布者v0.1.6更新于 Nov 6, 2026

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

已验证Streamable HTTP可网页运行效率与工作流网页搜索与抓取数据与分析

概览

AI 生成的概览

AgentSEO 为 AI 助手提供实时 SEO 情报工具：Google 搜索、SERP 分析、关键词、外链与内容规划工作流。

可以做什么
  • 搜索网页并将页面内容提取为 Markdown，附带 SERP 与竞争对手分析
  • 研究关键词、域名排名、流量估算、竞争对手与内容缺口
  • 审计外链：汇总、列表、锚文本、引荐域名、新增/丢失趋势与链接缺口机会
  • 规划与检查内容：简报、大纲、草稿、标题与描述、结构化数据、内链、关键词映射与自相残杀检测
  • 审计站点与页面：站点地图覆盖、发布前技术检查、落地页转化检查、程序化模板与行动计划
  • 构建 AI 可见性提示词集，并审计 Google 地图商家信息
适用场景
适合 SEO 与内容团队或开发者，希望让助手在对话中完成关键词、外链、SERP 与内容规划调研，并产出可直接执行的简报。
运行要求
可使用远程端点，或在本地以 Node.js 运行 npm 包 @agentseo/mcp-server。需要 AgentSEO API 密钥，通过 AGENTSEO_API_KEY 环境变量或 x-api-key 请求头传入；可选 AGENTSEO_PROJECT_ID 与 AGENTSEO_WORKFLOW_ID 归属头，以及可选的 AGENTSEO_API_URL 基础地址。需要访问 AgentSEO API 的网络。
安装前请注意
API 密钥属于服务端机密，不应提交到代码库或外泄。托管 API 负责计费与供应商调用，使用工具可能消耗付费额度；其中一个工具被描述为在花费更深入分析额度前比较流量估算。请求会把查询、域名和提供的页面内容发送到 AgentSEO 的服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AgentSEO，将其添加到工作区。
  2. 连接 Custom headers 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/dev.agentseo.www%2Fagentseo-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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.

来源：README.md，提交 59dfd02

工具

45

agentseo_extract

AgentSEO Extract

Extract content from a URL and convert to Markdown.

输入参数url必填include_images

agentseo_analyze_serp

AgentSEO Analyze SERP

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

输入参数syncdevicekeyword必填languagelocation

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.

输入参数synclanguagelocation必填business_name必填

agentseo_content_gap

AgentSEO Content Gap

Run content gap analysis for a URL and keyword.

输入参数url必填synckeyword必填languagelocationscrape_depth

agentseo_opportunities_find

AgentSEO Opportunity Finder

Find prioritized SEO opportunities for a domain or URL.

输入参数synctarget必填languagelocationkeyword_limitopportunity_limitinclude_serp_competitorsinclude_competitor_discovery

agentseo_opportunities_brief

AgentSEO Opportunity Brief

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

输入参数synctarget必填keyword必填languagelocationpage_urlcurrent_rankopportunity_typeinclude_competitor_outlines

agentseo_content_refresh_brief

AgentSEO Content Refresh Brief

Create a refresh brief for an existing URL and keyword.

输入参数url必填synckeyword必填languagelocationscrape_depth

agentseo_content_serp_outline

AgentSEO SERP Outline

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

输入参数syncdevicetargetkeyword必填languagelocationoutline_depthinclude_title_options

agentseo_content_brief

AgentSEO Content Brief

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

输入参数syncdevicetargetkeyword必填audiencelanguagelocationpage_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.

输入参数syncdevicetargetkeyword必填languagelocationqa_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.

输入参数urlsynctargetkeywordpage_typepage_markdowninclude_jsonld

agentseo_content_internal_links

AgentSEO Content Internal Links

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

输入参数synctargetkeywordsource_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.

输入参数urlsynctargetkeyword必填page_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.

输入参数syncpages必填targetkeywords必填max_mappings

agentseo_content_technical_qa

AgentSEO Content Technical QA

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

输入参数urlhtmlsynctargetkeywordmarkdownpage_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.

输入参数goalsyncteamitems必填targetstart_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.

输入参数synctargetcrawl_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.

输入参数syncdevicetargetkeyword必填locationsnapshots必填sensitivitytarget_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.

输入参数urlhtmlsynctargetkeywordaudiencemarkdownpage_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.

输入参数synclocaletarget必填topics必填cadenceaudiencecategory必填personasplatformscompetitorsowned_assetsprompt_count另有 3 个

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.

输入参数synctargetaudienceplaybookpage_goalvariables必填competitorsurl_pattern必填data_sources必填unique_fieldsconversion_ctainclude_schema另有 5 个

agentseo_content_cannibalization

AgentSEO Content Cannibalization

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

输入参数syncpages必填targetsensitivityfocus_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.

输入参数synctargetown_pagescompetitors必填focus_topicsmax_opportunities

agentseo_keyword_ideas_suggest

AgentSEO Keyword Ideas Suggest

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

输入参数synclimitkeyword必填languagelocationexact_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.

输入参数syncsort_bykeywords必填languagelocationlocation_codemin_search_volume

agentseo_domain_ranked_keywords

AgentSEO Domain Ranked Keywords

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

输入参数synclimittarget必填sort_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.

输入参数synclimittarget必填sort_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.

输入参数synclimittarget必填sort_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.

输入参数synclimitsort_bytarget1必填target2必填languagelocationintersectionslocation_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.

输入参数syncsort_bytargets必填languagelocationinclude_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.

输入参数synclimitoffsetsort_bytargets必填min_rankrank_scalebroken_onlydofollow_onlymin_page_rankmax_spam_scoreexclude_targets另有 6 个

agentseo_page_intersection

AgentSEO Page Intersection

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

输入参数synclimitpages必填offsetsort_bylanguagelocationmax_rankitem_typesexclude_pageslocation_codeignore_synonyms另有 5 个

agentseo_ai_overview_extract

AgentSEO AI Overview Extract

Extract AI Overview insights for a target keyword.

输入参数synckeyword必填languagelocationtarget_domain

agentseo_local_visibility_track

AgentSEO Local Visibility Track

Track local visibility for a domain across keywords and locations.

输入参数syncdomain必填keywords必填languagelocations必填

agentseo_rank_track

AgentSEO Rank Track

Queue a rank tracking check for a URL and keyword.

输入参数url必填synckeyword必填location

agentseo_job_status

AgentSEO Job Status

Get status/result for a previously queued job.

输入参数job_id必填

版本历史

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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分