关于 AgentSEO
AgentSEO 为 AI Agent 和开发者工作流提供 SEO 情报 API 的客户端集成，包含 JavaScript、Python SDK 和 MCP 服务。托管 API 与后端处理不在此仓库中。
主要功能
- 01JavaScript／TypeScript SDK
- 02Python SDK
- 03MCP 服务集成
适用场景
- 01在 JavaScript 项目中调用 SEO 搜索
- 02从 Python 工作流查询 SEO 数据
- 03通过 MCP 将 SEO 功能提供给 Agent
MCP 相关
仓库包含 AgentSEO 的 MCP 服务，客户端可通过它访问 AgentSEO API。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
服务地址
https://www.agentseo.dev/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http dev-agentseo-www-agentseo https://www.agentseo.dev/mcpCursor.cursor/mcp.json
{"mcpServers":{"dev-agentseo-www-agentseo":{"type":"http","url":"https://www.agentseo.dev/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"dev-agentseo-www-agentseo":{"type":"http","url":"https://www.agentseo.dev/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"dev-agentseo-www-agentseo":{"type":"http","url":"https://www.agentseo.dev/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"dev-agentseo-www-agentseo":{"serverUrl":"https://www.agentseo.dev/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://www.agentseo.dev/mcp需要授权工具
45| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| sync | boolean | 否 | |
| limit | integer | 否 | |
| query | string | 是 | 搜索查询 |
| exclude_domains | array | 否 | |
| include_domains | array | 否 |
详细介绍
AgentSEO 客户端
AgentSEO 的官方开源客户端。AgentSEO 是面向 AI Agent 和开发者工作流的 SEO 智能 API。
此仓库仅包含集成层：
packages/js-sdk- JavaScript/TypeScript SDKpackages/python-sdk- Python SDKpackages/mcp-server- Model Context Protocol 服务
托管的 AgentSEO API、工作器系统、提供商编排、计费和转换逻辑均不属于此仓库。
快速开始
使用 JavaScript SDK：
npm install @agentseo/sdk
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);
使用 Python SDK：
pip install agentseo-sdk
from agentseo_sdk import AgentSEOClient
client = AgentSEOClient(api_key="sk_live_...")
result = client.search(query="seo api", sync=True)
print(result)
使用 MCP 服务：
export AGENTSEO_API_KEY="sk_live_your_key"
npx -y @agentseo/mcp-server
开发
构建 JavaScript SDK：
cd packages/js-sdk
npm install
npm run build
构建 MCP 服务：
cd packages/mcp-server
npm install
npm run build
在本地安装 Python SDK：
cd packages/python-sdk
python -m pip install -e .
安全
请勿提交 API 密钥、.env 文件、客户数据或提供商凭据。请参阅 SECURITY.md。
许可证
MIT。请参阅各软件包中的 LICENSE 文件。
评论
支持 Markdown
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。