MCP 連線指南

在 AI 中,查詢與調用你關注的網站報告。

想評估外鏈合作、客座文章投稿的網站,或比較競爭對手?透過 AI 查詢 Ahrefs DR、外鏈、搜尋流量與 AI 回應,再調用已購報告分析。無需擁有被查詢網站,也不必購買 Ahrefs 帳戶。

從你要做的合作判斷出發

篩選外鏈合作網站

聯繫前請 AI 比較 DR、引用網域、Dofollow 外鏈與搜尋流量,指出待核對差異,不只看一個分數。

評估客座文章投稿機會

結合發布網站的外鏈、自然流量 TOP3 國家與 AI 回應,判斷是否值得深入評估及受眾地區是否符合需求。

了解競爭對手

比較多個網站的報告,也能免費調用已購快照。請 AI 先說明查詢及資料時間,避免把舊資料當成剛取得的資料。

三步完成連線

  1. 產生連線憑證

    登入已驗證帳戶,前往使用者中心 / 連接 AI 用戶端(MCP)。要新查網站,開啟「允許使用額度查詢」,產生或更換憑證並更新用戶端;只讀已購歷史可保留唯讀。

  2. 在 AI 用戶端新增服務

    選擇遠端 MCP 與 Streamable HTTP,填入下方網址。將 Authorization 標頭設為 Bearer、空格及憑證;如有獨立 Bearer Token 欄位,只填憑證。

  3. 先讀取歷史報告

    請 AI 列出最近查詢,再開啟已購結果,這些操作不扣額度。新查詢前,先確認網域、是否包含 AI 回應與總額度。

連線參數

連線網址
https://ahrefsdr.com/mcp
傳輸方式
Streamable HTTP
身分驗證
Authorization: Bearer <token>

用戶端須支援遠端 Streamable HTTP,以及自訂 Authorization 標頭或 Bearer Token。僅支援 OAuth 或本機 stdio 的用戶端需要相容轉接器。使用本站帳戶憑證即可,不需要 Ahrefs API 金鑰。

如何扣除額度

操作消耗額度
列出歷史或查看已購結果0
新查詢:1 個網站,基礎報告1
新查詢:1 個網站,基礎 + AI 回應2
新查詢:2 個網站,基礎報告2
新查詢:2 個網站,基礎 + AI 回應4
  • N 個去重網站:基礎扣 N 次,含 AI 扣 2 × N 次。MCP 每次工具呼叫查一個網域;多站查詢前請先去重並確認總額度。
  • 基礎失敗返還基礎額度;僅 AI 失敗返還額外 1 次並保留基礎結果。處理中可能預留額度,完成或異常復原後結算。
  • 重新查詢或更新會使用額度。免費查看已購報告時,保留你當次購買的結果。
  • 每日 MCP 上限計算額度而非網站數,每天 UTC 00:00 重置,預設 20,產生憑證時可設 1–2,000。只限制 MCP 新查詢,不增加餘額或限制網頁查詢。各訂單額度自購買日起一年有效。

每日上限、帳戶餘額與免費歷史讀取

上限計算額度,不是工具呼叫次數

產生憑證時可在使用者中心設定每日 MCP 上限,預設 20,可設 1–2,000。餘額足夠時,20 次最多可查 20 份基礎報告或 10 份含 AI 報告;讀取歷史不占上限。每天 UTC 00:00 重置,修改後須重新產生憑證。

達到每日上限後

新查詢會在開始前被阻擋。可等 UTC 次日重置,或調整上限並產生新憑證。若只剩 1 次,可查基礎報告,不能開始需 2 次的含 AI 查詢。提高上限不會增加帳戶餘額。

餘額用完還能讀取歷史嗎?

可以。憑證有效時,仍能免費列出及讀取本人已購歷史,達到每日上限也一樣。餘額不足須充值才能開始新付費查詢;每日額度不能代替餘額。憑證過期或撤銷後,讀取歷史也須換新憑證。

歷史與新查詢的差別

歷史工具傳回購買時的報告,保留原查詢與資料日期,不扣次也不自動更新。每日額度用完後,仍可免費讀取歷史報告與「我的專案」。新查詢基礎扣1次,含AI共扣2次。請AI先說明是讀取已購報告,還是開始新的付費查詢。

範例:Claude Code

在本機私有 MCP 設定中,將 YOUR_MCP_TOKEN 替換為使用者中心產生的憑證。請勿提交至程式碼儲存庫或貼入 AI 對話。以下格式適用於 Claude Code,其他用戶端格式可能不同。

{
  "mcpServers": {
    "ahrefsdr": {
      "type": "http",
      "url": "https://ahrefsdr.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_TOKEN"
      }
    }
  }
}

儲存並重新連線後檢查工具。唯讀可用 list_queries、get_query、get_my_project;允許付費的憑證另有 check_domain。

Claude Code · MCP

AI 可以做什麼

工具用途
list_queries列出帳戶最近最多 50 筆查詢,含編號與時間,免費。
get_query以 query_id 讀取本人已購快照,免費。
get_my_project免費讀取「我的專案」與已購報告作為預設比較基準,不更新資料。未設定時詢問基準網址。
check_domain查詢一個網站。須有付費權限、足夠餘額和每日額度、UUID request_id;基礎 confirm_credits = 1,含 AI 使用 include_ai: true 與 confirm_credits = 2。

連接 MCP 後,如何向 AI 提問:案例

09

先了解單一目標網站,也能依合作、競爭或推廣目的,將「我的專案」與一個或多個網站比較。

AI 會先用 get_my_project 免費讀取「我的專案」及已購報告作為比較基準,不必重填網址。未固定專案時才詢問自有網址;也可改選基準,沒有網站仍能評估目標。

  1. 適合所有人

    先了解單一網站

    以 DR、UR、外鏈、引用網域、自然搜尋與 AI 回應評估 [目標網域],整理優勢、風險、值得深入了解的方向與缺少的證據。

  2. 已有網站

    單站外鏈合作評估

    先呼叫 get_my_project,免費讀取「我的專案」已購報告作為基準;沒有可用專案時才詢問我的網址。判斷 [目標網域] 是否適合外鏈合作。確認合作目的,再分析外鏈、Dofollow 來源與流量,說明優缺點。

  3. 適合所有人

    單站 Affiliate 合作評估

    評估 [目標網域] 的自然流量、TOP3 國家、外鏈及 AI 回應,區分報告依據與仍須確認的受眾、佣金及轉換資料。

  4. 適合所有人

    這個網站是否適合投稿客座文章

    我準備向 [目標網域] 投稿面向 [國家或讀者] 的客座文章。請評估外鏈實力、自然流量與國家,列出優勢、風險及聯繫前須確認的編輯要求與連結政策。

  5. 已有網站

    我的專案與單站比較

    先呼叫 get_my_project,免費讀取「我的專案」已購報告作為基準;沒有可用專案時才詢問我的網址。與 [目標網域] 依 [目的] 比較優勢、差距、互補性及報告時間。

  6. 已有網站

    我的專案與多站比較

    先呼叫 get_my_project,免費讀取「我的專案」已購報告作為基準;沒有可用專案時才詢問我的網址。與 [目標清單] 按 [外鏈、Affiliate、客座文章或競品目的] 排序,逐站說明優缺點及證據缺口。

  7. 適合所有人

    競品流量與搜尋廣告

    分析 [一個或多個競品] 的預估自然流量、關鍵字、TOP3 國家、付費關鍵字與預估付費流量及成本,不把估算當實際支出或獲利。

  8. 尋找產業機會

    沒有網站,先研究具體樣本

    我尚無網站。先分析 [目標或候選清單] 在 [產業] 的報告,再梳理切入課題、內容及 AI 可見度方向與待驗證問題,不把流量當收入。

  9. 適合所有人

    免費重看已購報告

    列出最近查詢並開啟我選的已購報告,標明查詢及資料時間後摘要。只讀歷史,不新查、不扣額度。

要透過 AI 新查詢並評估網站,建議在使用者中心開啟「允許使用額度查詢」,產生或更換 MCP 憑證並更新用戶端。未開啟時只能免費讀取本帳戶已購歷史報告,不能新查網站。新查詢仍須有足夠餘額並符合每日上限。

優先讀取已購報告。新查詢前先確認網域、是否包含 AI 回應與總額度,並說明查詢及資料時間、缺漏,不編造結論。

使用者中心有三檔:關閉禁止新查 AI;自動由用戶端選擇、省略時不含 AI;預設開啟會包含 AI,但可明確指定基礎。include_ai: false 為基礎 1 次,include_ai: true 在允許時含 AI 共 2 次。先確認選擇與總額度。網頁開關獨立,已購專案與歷史免費讀取且不變。

區分歷史與新查詢

access.kind 分為 historical_read、new_query、existing_request。queriedAt 是購買/查詢時間,dataAsOf 是 DR、基礎與 AI 的來源時間,retrievedAt 是讀取時間,皆為 ISO 8601 UTC。舊紀錄缺少的時間保持未知。請 AI 說明時間及 access.billing 中的扣除、返還與實際消耗。

重試與憑證管理

同一操作重試應保留相同 request_id 和參數,避免重複購買;新的 request_id 是新查詢。憑證僅顯示一次,90 天到期;重新產生會停用舊憑證,不再使用時可於使用者中心撤銷。

連線疑難排解

401 / 無法驗證

確認憑證有效、未過期或被替換,標頭為 Authorization: Bearer <token>。

唯讀或每日上限

允許付費查詢或調整每日上限後,請產生新憑證,並確認帳戶餘額。

瀏覽 /mcp 顯示 405

這是 MCP POST 介面而非網頁。Streamable HTTP 是傳輸方式,不是網址的一部分。

403 / 不相容用戶端

部分網頁用戶端傳送不同 Origin 或無法設定標頭。請用相容的遠端 HTTP 用戶端;本站不提供 OAuth 登入。