MCP Link Intelligence 使用說明

服務概覽

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

大量發布後的頻道同步

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

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

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

Agent 應如何使用

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

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

工具一覽

plan_links：整篇文章規劃

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

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

{
  "planId": "request trace id",
  "policyVersion": "2026-07-26.v4",
  "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 與建議結果。

排序與準確度政策

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

{
  "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(公開、零機密),每次部署自動更新,一行安裝:

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

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)工作流程

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

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