MCP Server

MCP 指南

提供 Agent 可直接讀取的公開 contract：從整篇草稿規劃內部連結、查詢 Tenten 自有內容資產、提交新文章，並在發佈後驗證實際 Link Graph。

服務概覽

Endpoint	`https://index.tenten.dev/api/mcp`
傳輸協定	Streamable HTTP
公開政策資源	`tenten://link-policy/current`

本頁只提供公開 contract、政策與工作流程，不包含任何私密設定值。Agent 可安全讀取並據此規劃工具呼叫。

YOUR CREDENTIAL

取得 API / MCP Token

尚未登入

登入後可在這裡建立、複製與撤銷自己的 Token。同一把 Token 可用於 MCP endpoint 與 REST API。

登入以取得 Token

REST API

CI script 與一般後端可使用與 MCP 相同的 Bearer Token 呼叫以下 JSON endpoints。所有回應皆不快取。

`POST /api/links/plan`	接受與 `plan_links` 相同的 JSON body，回傳相同的 link plan result。
`GET /api/links/status?url=...`	依文章 URL 查詢 crawl、enrichment、live edges 與建議發布狀態。

大量發布後的頻道同步

已註冊的 channel 不需要再次新增。大量發布文章後呼叫 refresh_channel，server 會讀取既有 feed、展開全部 hreflang locale，並建立可持續追蹤的批次工作。

incremental request

{
  "channel_key": "geo",
  "mode": "incremental"
}

status request

{
  "job_id": "refresh_channel 回傳的 jobId"
}

incremental	只建立尚未入庫的 URL;既有 metadata 與 keywords 不變。
full	新增缺少 URL，並把既有內容重新排入 metadata／keyword enrichment。
多語系	每個 hreflang URL 都是獨立 content row，可依 zh／en locale 搜尋與選鏈。
外部提交	同步不會一次送出數百篇;IndexNow／Google posture 仍由既有 submission cron 控制。

Agent 應如何使用

先用 quota_report 完成認證前置檢查，再於草稿完成後呼叫一次 plan_links。
使用 suggestions 回傳的原文 anchor span；不得自行創造草稿中不存在的 anchor。
partial／no_match 且 retryable=false 是正常終止結果，不得用相同草稿重跑。
發布後呼叫 submit_url，取得 content ID 與 crawl job ID。
呼叫 check_link_status，確認實際發布連結已被 crawl 並寫入 Link Graph。

search_content 保留給精準補查、除錯與既有 client；一般文章的預設入口是 plan_links。

工具一覽

工具	參數	用途
`start_optimization_task`	task_id 必填	以目前 Agent 身分認領待辦任務，避免重複處理；已被認領的工作不能覆寫負責人。
`list_content`	query、channel、locale、status、sort、page 可選	瀏覽完整歷史內容庫，支援伺服器分頁及非上線內容；用於內容營運盤點。
`get_content_detail`	content_id 必填	一次讀取內容、搜尋期間、查詢、索引、內鏈、引用與任務證據；不觸發抓取或寫入。
`get_content_brief`	content_id 必填	從已有證據產生可交接的 Markdown 更新 Brief；保留缺失資料與觀測限制，不授權發布。
`list_my_portfolios`	需個人 MCP Token	列出Token擁有者的私人內容組合，共用部署Token無法存取私人工作區。
`get_my_portfolio`	portfolio_id 必填；需個人 MCP Token	查看本人組合的成員與分來源、同期間成效；最多500篇。
`get_portfolio_brief`	portfolio_id、content_ids（1–20篇）必填；需個人 MCP Token	輸出本人組合的多篇Brief工作包；保留來源狀態與期間，上限2MiB，不會認領或發布。
`list_my_topic_plans`	query、status、channel、page 可選；需個人 MCP Token	每頁50筆瀏覽本人的內容規劃。目標查詢屬於編輯計畫，不代表實際搜尋量。
`get_topic_plan_brief`	plan_id 必填；需個人 MCP Token	取得本人單篇新內容規劃的意圖、大綱與Markdown Brief，不執行內容生成或發布。
`compare_content`	content_ids（2–4篇）必填	並排取得多篇內容證據；保留來源期間與缺資料狀態，不把重疊直接判為SEO傷害。
`system_health`	無	查看各整合最近一次執行與資料新鮮度。
`track_ai_citation_query`	query 必填；locale、priority 可選	將查詢加入 AI 引用觀測清單。
`list_ai_citation_queries`	limit 可選	取得待觀測的查詢、語系與最近觀測時間。
`list_ai_citation_insights`	days 1–365 可選，預設 28	依 provider 彙整直接觀測的 citation rate、未歸戶引用與最近證據；不混用 referral 或 crawler 訊號。
`record_ai_citation`	provider、query、cited、observed_at 必填；引用時 citation_url 必填	外部 Agent 真實查詢 AI answer 後寫回正／負 citation evidence；同日等價證據 idempotent，禁止由其他訊號推測。
`inspect_url`	content_id 必填	索引或 canonical 修正發布後立即重跑 Google URL Inspection；保存最新證據，通過時自動完成收錄修復任務。
`list_optimization_tasks`	task_type、limit 可選	依 impact 取得 Search Console 流量衰退、低 CTR、排名推進、canonical 與收錄修復任務，含建立時 baseline。
`complete_optimization_task`	task_id、proof 必填	內容完成更新並發布後關閉任務；proof 會保留為成效回流與交付證據。
`dismiss_optimization_task`	task_id、reason 必填	訊號不適用時附具體原因略過任務，保留決策證據並釋放同內容／類型的 active queue slot。
`refresh_channel`	channel_key 必填;mode 為 incremental(預設)或 full	強制重新同步已註冊且啟用的頻道。incremental 只補新 URL;full 同時重做既有內容 enrichment。每個 sitemap locale 都會獨立入庫。
`check_channel_sync`	job_id 必填	查詢頻道同步工作的 queued/running/completed 狀態、進度計數與有限錯誤清單。
`plan_links`	title、locale 與 content/content_summary 擇一;source_url、max_links 可選	從草稿先抽取可編輯 anchor，再以單次批次檢索規劃 3–5 個內部連結。回傳 edits、終止狀態、target、信心、原因與階段 latency。
`search_content`	query 必填;locale、limit(1–50,預設 10)	向後相容的精準查詢與除錯工具。v2 新增來源排除、channel 過濾、reason codes 與 policy version。
`check_link_status`	url、content_id、plan_id 或 crawl_job_id	查詢非同步 crawl、enrichment、已驗證 link graph 與建議發布狀態。
`submit_url`	url 必填;priority 1–3(預設 1)	文章發佈後提交進索引池,自動排入 Google Indexing API 與 IndexNow 提交。超過 6 個月的舊文自動排除 Google(僅走 IndexNow)。
`check_status`	url 必填	查詢 URL 是否已入池,以及 Google / IndexNow 的提交歷史。
`quota_report`	無	當日(太平洋時區)Google Indexing API 配額用量與待提交數。
`list_recent`	limit(預設 20)	最近入池的 URL 清單。

plan_links：整篇文章規劃

Server 會先從草稿擷取最多 8 個具備精確 offset 的 anchor，再以一次資料庫 round-trip 批次檢索候選、套用硬性政策並去除重複 target。準確度不足時會明確終止，不要求 Agent 補滿配額。

request

{
  "title": "Shopify 結帳優化完整指南",
  "locale": "zh",
  "content": "完整文章草稿內容",
  "source_url": "https://tenten.co/shopify/example/",
  "max_links": 5,
  "mode": "refresh"
}

response shape

{
  "planId": "request trace id",
  "policyVersion": "2026-10-11.v5",
  "retrievalVersion": "lexical-v6-title-alignment",
  "retrievalMode": "lexical",
  "status": "complete",
  "retryable": false,
  "terminalReason": "recommended_links_found",
  "cacheHit": false,
  "concepts": ["Shopify 結帳優化"],
  "suggestions": [{
    "targetUrl": "https://tenten.co/shopify/target/",
    "targetTitle": "相關文章標題",
    "anchorText": "草稿中原本存在的詞組",
    "start": 120,
    "end": 132,
    "confidence": 95,
    "relevanceBand": "high",
    "reasonCodes": ["exact_topic", "quality_floor", "traffic_proven"]
  }],
  "edits": [{
    "operation": "wrap_link",
    "start": 120,
    "end": 132,
    "anchorText": "草稿中原本存在的詞組",
    "targetUrl": "https://tenten.co/shopify/target/"
  }],
  "coverage": { "concepts": 5, "linked": 3 },
  "warnings": [],
  "latencyMs": { "total": 820, "cacheLookup": 20, "extraction": 2, "retrieval": 770, "composition": 1, "persistence": 27 }
}

content 與 content_summary 擇一。完整草稿不會永久保存；audit 只保留內容 hash、抽取概念、必要 source quote 與建議結果。

排序與準確度政策

Anchor gate：拒絕泛用單字、英文子字串與任意斷詞；只有具體、可編輯且可承載主題的原文片語能進 retrieval。
Hard filters：只保留 live canonical、同語言、非自連、未重複且非 broken／redirect 的內容。
Hybrid recall：結合 structured terms、全文搜尋、title、description 與文章 keywords。
Relevance gate：候選分為 high、medium、reject；title focus、title mention、metadata exact 與 contextual match 另分證據層級，reject 不會進入推薦。
Title alignment：版本號／產品型 anchor（例如 Claude Opus 5）必須完整出現在 target title；只在 keywords 提到競品不算合格。
可解釋排序：排除公司名稱 anchor → relevance band → match tier → semantic score → context corroboration → metadata quality floor → 28-day traffic → quality score → freshness → strategic priority → graph need。
組合限制：同 target 一次、同 cluster 預設最多兩篇、anchor 必須存在於草稿原文。

Quality floor 高於連結數：沒有安全候選時會回傳 no_match，不會為湊滿 3–5 條而使用泛用 anchor。Agent 可讀取 MCP resource tenten://link-policy/current 取得目前 policy version、硬性規則與 reason code 定義，避免本地 prompt 與 server 規則漂移。

發布後驗證與閉環

submit_url 會回傳 contentId 與 crawlJobId，並排程抓取發布頁面。Crawler 只解析正文中的 Tenten 自有連結，更新實際 source → target graph。

status request

{
  "crawl_job_id": "crawl:1234"
}

check_link_status 會分開回報 crawl、enrichment、live edges，以及 suggested、accepted、published、rejected 數量。只有 crawler 實際觀察到吻合的 target 與 anchor，建議才會變成 published。

Crawl 失敗時保留上一版 graph 並標記 stale／failed，不會因單次抓取失敗刪除既有連結。

安裝 Link Building Skill(建議)

與其讓每個 Agent 自行摸索工具,直接安裝官方 skill——內含完整工作流程、連結政策與錯誤處理。skill 由本站發佈於 /skill.md(公開、零機密),每次部署自動更新,一行安裝:

Claude Code

mkdir -p ~/.claude/skills/tenten-link-building && \
  curl -fsSL https://index.tenten.dev/skill.md \
  -o ~/.claude/skills/tenten-link-building/SKILL.md

Codex CLI

mkdir -p ~/.agents/skills/tenten-link-building && \
  curl -fsSL https://index.tenten.dev/skill.md \
  -o ~/.agents/skills/tenten-link-building/SKILL.md

安裝後,Agent 在寫 Tenten 文章時會自動觸發 skill(觸發詞:internal linking、link building、內部連結、站內連結)。搭配上方的 MCP 連線設定即可運作;更新 skill 只需重跑同一行指令。

內部連結(Link Building)工作流程

先呼叫 quota_report 驗證目前 Agent process 的認證；成功後，草稿完成只呼叫一次 plan_links。
依 suggestions 的原文 anchor span 插入連結;低信心或 warning 時寧可少放。search_content 保留給人工補查與診斷。
status=partial/no_match 且 retryable=false 時立即終止，不重跑相同草稿。
server 先執行標題／關聯門檻與 semantic score,再以流量、品質、日期、策略重要度與 graph gap 作後段排序;Agent 不需自行重排。
依政策插入連結(見下),anchor text 用句子裡本來就有的詞組,自然融入。
發佈後呼叫 submit_url,再用回傳的 crawl job 呼叫 check_link_status,確認實際 link graph 已更新。

每篇連結數	3–5 個(找不到好目標就少放,不硬湊)
語言	只連同語言內容(zh 文章 → zh 頁面)
自連	禁止連到文章自己的 URL
重複	同一目標 URL 每篇最多出現 1 次

完整政策與觸發條件見 repo 內 skills/tenten-link-building/SKILL.md;跨平台設定教學亦發佈於 skills.tenten.co。

總覽

正在讀取內容成果與今天的工作。