SEOG — 在地SEO via MCP 是做什麼的？
概覽
SEOG (seog.ai) 是一個專為依賴Google Maps的商家設計的AI在地SEO平台。 其遠端MCP伺服器將整個產品以 90 項工具 的形式開放 — 這些工具與網頁應用程式中按鈕所呼叫的領域服務相同 — 讓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. 為每個未回覆的負面評論產生回覆草稿 → 呈現草稿
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 仍需在網頁應用程式中進行 (處理檔案位元組和瀏覽器操作)。其他所有功能皆可在此使用。
- ID 是限定於令牌所屬帳號的 UUID — 如果一個看似有效的 UUID 回傳 404，通常表示它屬於另一個帳號。
- 令牌是憑證：切勿將其提交至版本控制，並從日誌和對話記錄中將其清除。401 錯誤表示令牌已在設定中被撤銷 — 請要求使用者重新核發。