SEOG — MCP 驱动本地 SEO 是做什么的？
概览
SEOG (seog.ai) 是一个面向依赖 Google Maps 的企业的人工智能本地 SEO 平台。其远程 MCP 服务器将整个产品以 90 个工具 的形式暴露出来——这些工具与 Web 应用按钮调用的领域服务相同——因此 AI 代理无需打开浏览器即可运行完整的本地 SEO 工作流程：导入商家、追踪排名检查关键词、在地理网格上扫描地图可见性、同步并回答 Google 评论、监控竞争对手、审计网站和 Search Console、发布 Google 帖子以及生成 PDF 报告。
端点：https://api.seog.ai/mcp（可流式传输 HTTP），使用个人令牌进行身份验证。每次调用都以该 SEOG 账户的身份运行——没有匿名模式。
指令
设置
请在 https://app.seog.ai 注册，然后转到 设置 → MCP 访问 以创建个人令牌（仅显示一次）。按以下任一方式安装：
作为 Claude Code 插件安装（推荐——捆绑此技能 和 服务器配置）：
/plugin marketplace add TerminalSkills/skills
/plugin install seog@terminal-skills
Claude Code 会在安装时询问令牌，并将其存储在凭据存储中。
非交互式（脚本、CI）：
claude plugin marketplace add TerminalSkills/skills
claude plugin install seog@terminal-skills --config mcp_token="$SEOG_MCP_TOKEN"
使用 /plugin list（seog → 已启用）和 /mcp（seog → 已连接）验证。
作为技能 + 手动注册 MCP 服务器（适用于任何客户端）：
npx terminal-skills install seog
claude mcp add --transport http seog https://api.seog.ai/mcp \
--header "Authorization: Bearer $SEOG_MCP_TOKEN"
对于 Codex / Gemini CLI / Cursor，请注册一个使用相同 URL 和 Authorization: Bearer 头的 HTTP MCP 服务器。使用 tools/list 验证——服务器 seog-platform 提供 90 个工具（白标账户提供较少工具，请参阅指南）。
账户、套餐与积分——运行付费工具前请阅读
- 令牌标识一个 SEOG 账户；工具仅对该账户的数据执行操作。
- SEOG 采用 积分 (CR) 计费，规则如下：任何调用外部 API 的操作均为付费操作，价格与应用中同等点击操作相同。读取已存储数据则免费。这包括撤销和删除——每次操作都会对 Google 发起一次调用。
get_credit_balance返回余额 + 套餐信息；list_feature_prices列出每个付费工具的价格。在跨多商家批量操作前务必检查这两项。- 失败的付费工具 不会 被收费（交付即退款原则），因此失败的运行不会悄悄造成费用损失。
create_report是唯一的异步情况：它立即返回 QUEUED 状态报告，费用在 PDF 生成时扣取（若失败则退款），因此请轮询get_report而不是假定积分在入队时就已扣除。
工具地图
完整参数模式和定价说明：references/mcp-tools.md。
💳 = 消耗积分。
| 领域 | 工具 |
|---|---|
| 商家 | list_businesses, get_business, search_places💳, import_business💳, update_business, delete_business |
| 资料健康 | get_business_audit, get_action_plan, list_recommendations, analyze_business_profile, set_recommendation_status |
| 资料编辑（写入 Google） | apply_profile_fix💳, undo_profile_fix💳, draft_business_description💳, apply_business_description💳, undo_business_description💳, list_profile_photos, delete_profile_photo💳, get_profile_fix_options, list_recent_profile_edits |
| 排名 | list_keywords, add_keyword💳, check_keyword💳, refresh_rankings💳, keyword_history, keyword_recommendations💳, keyword_recommendations_cache, toggle_keyword, remove_keyword |
| 地图网格 + AI 回答 | run_grid_scan💳, get_latest_grid_scan, get_keyword_grid_scan, get_grid_history, get_grid_snapshot, check_ai_overview💳, get_ai_overview |
| 评论 | list_reviews, review_stats, sync_reviews💳, draft_review_response, generate_review_reply💳, publish_review_reply💳, verify_review_reply💳 |
| 竞争对手 | discover_competitors💳, get_discovered_competitors, list_competitors, add_competitor💳, remove_competitor, set_competitor_watchlist, snapshot_competitor💳, refresh_competitors💳, compare_competitors, list_competitor_alerts, mark_competitor_alerts_read, scan_competitor_spam |
| AI 可见性 | get_ai_visibility, get_ai_visibility_pillars, get_ai_presence_matrix, check_ai_visibility💳, list_citations, check_citations💳 |
| 网站 + Search Console | get_website_analysis, refresh_website_analysis💳, refresh_website_all💳, get_search_performance, get_search_console_status, load_search_performance💳 |
| Google 帖子 | list_posts, get_post_templates, validate_post, draft_post_content💳, publish_post💳, refresh_posts💳, delete_post💳 |
| Google 连接 | get_google_connection_status, get_gbp_performance, load_gbp_performance💳, load_gbp_keyword_history💳, list_gbp_import_locations, import_gbp_business💳 |
| 账户 + 报告 | get_dashboard, get_credit_balance, list_feature_prices, get_metrics_history, list_reports, create_report💳, get_report, delete_report, refresh_business_profile💳, refresh_business_overview💳 |
核心工作流程
入驻 — search_places → 使用所选 placeId 调用 import_business。如果用户的 Google 账户已连接，请优先使用 list_gbp_import_locations → import_gbp_business：此流程会绑定所有者连接，这是解锁评论回复和帖子功能的前提。
追踪排名 — 付费调用 keyword_recommendations 前，先读取 keyword_recommendations_cache（免费）；add_keyword（可选 locationLabel 参数以指定小区级排名）；check_keyword 进行单次实时检查，或 refresh_rankings 一次性检查所有活跃关键词（仅一次收费）；keyword_history 查看趋势；run_grid_scan 进行跨网格的地图覆盖扫描（价格随 gridSize 递增）。
处理评论 — sync_reviews → list_reviews(filter="needs-response") → generate_review_reply 生成草稿 → 询问用户 → publish_review_reply（在 Google 上公开可见） → verify_review_reply 确认已发布。draft_review_response 保存本地草稿，不会发布任何内容。
修复资料 — 使用 get_action_plan / get_business_audit 查找差距，然后调用 apply_profile_fix（电话、网站、营业时间、名称、状态）或 draft_business_description → apply_business_description。两者都会写入实时列表；undo_profile_fix / undo_business_description 可撤销更改。
超越资料本身的诊断 — get_website_analysis + get_search_performance（免费读取最近运行结果），refresh_website_all 一次性重新运行两者（仅一次收费）；get_ai_visibility_pillars 和 list_citations 用于评估 AI 回答准备度和 NAP 一致性。
示例
示例 1：周报，积分感知
“我的客户这周表现如何？”
1. get_credit_balance → 180 CR（成长套餐）——足够进行批量操作
2. list_businesses → 15 个商家
3. 对每个商家：refresh_rankings # 一次收费检查所有活跃关键词
sync_reviews → list_reviews(filter="needs-response")
compare_competitors + list_competitor_alerts # 两者均免费
4. 为每条未回复的负面评论调用 generate_review_reply → 展示草稿
5. get_action_plan(businessId) → 为周报提供优先修复建议
发布操作 (publish_review_reply) 等待所有者的明确同意。
示例 2：批量操作中积分耗尽
> run_grid_scan(businessId, keywordId, gridSize=7)
✗ 积分不足：此操作需消耗 45 CR，账户余额为 12 CR。
未执行任何操作，也未产生任何费用。请前往
https://app.seog.ai/billing 充值或升级套餐，然后重试。
正确行为：转述数字和链接，停止付费操作（不要重试循环），并利用免费读取完成报告 — list_keywords、get_latest_grid_scan、review_stats、get_action_plan 等工具仍然可用。
指南
- 钱是真的。 切勿运行用户未要求的付费工具。使用
list_feature_prices估算批次价格，并首先检查get_credit_balance。优先选择捆绑收费（refresh_rankings、refresh_website_all、refresh_business_overview）而不是按项循环——相同工作量下成本更低。 - 发布操作是公开且难以撤销的。
publish_review_reply、publish_post、apply_profile_fix和apply_business_description会写入实时 Google 列表。请引用确切文本并获得批准后再执行。更改商家 名称 可能导致列表进入 Google 重新验证流程——操作前务必说明。 - 不可逆工具需要
confirm: true——delete_business、delete_profile_photo、delete_post、remove_keyword、remove_competitor、delete_report。不带此标志它们将拒绝运行，这是设计使然：请准确说明将被删除的内容，获得同意，然后传入该标志。delete_business会级联删除评论、关键词、排名和竞争对手；已删除的照片和帖子无法恢复。当用户只想暂停追踪时，请优先使用toggle_keyword。 - 读取错误信息而不是重试。 工具返回的错误信息本身包含说明：
INSUFFICIENT_CREDITS提供价格、余额和充值链接；PLAN_REQUIRED表示试用已结束或无有效套餐；FEATURE_NOT_IN_PLAN指出功能名称和所属套餐。请转述这些信息——重试循环只会再次失败。 - 某些工具因设计而缺失。 白标/代理账户不可以使用返回原始 Google 内容的工具（
search_places、check_keyword、sync_reviews、discover_competitors、run_grid_scan、import_gbp_business等）。如果某工具显示“未找到”，请说明该账户未被授权使用此工具，而不是简单猜测。 - 照片上传以及 Google / Search Console OAuth 需在 Web 应用中完成（涉及文件字节和浏览器）。其他所有功能均在此处可用。
- ID 是 UUID，作用域为令牌所属的账户——有效 UUID 返回 404 通常意味着它属于另一个账户。
- 令牌是一个凭证：切勿提交到代码仓库，并从日志和记录中清除。401 错误表示令牌已在设置中被撤销——请要求用户重新创建。