Ahrefs Firehoseは、AhrefsのクローラーAhrefsBotが取得したページのうち、自分で書いたルールに一致したものだけを、クロールした時点でServer-Sent Events(SSE)のストリームとして届けるWeb監視サービスです。2026年3月のベータ公開時は無料でしたが、現在はFreeからBusinessまでの4プランとAPI従量課金に分かれ、指定URLの変更を定期確認するURL Watchも含まれます。この記事では、仕組み・料金・APIでの受信手順に加え、公開版のクエリ検証APIで確かめたルールの実際の展開結果を、2026年11月12日時点の公式ドキュメントと実測で整理します。
まとめ:Ahrefs Firehoseの要点(2026年11月時点)
- Firehoseは「Web全体をパターンで監視するStream」と「指定URLを定期的に再クロールするURL Watch」の2系統です。監視するページを自分で決めるならURL Watch、クローラー任せでよいならStreamを使います。
- 料金はAhrefs本体とは別契約で、Free($0)・Starter($39/月)・Advanced($89/月)・Business($299/月)と、APIのみの従量課金(1,000マッチあたり$5)があります。Ahrefs APIのユニットは消費しません。
- APIは
fhm_で始まるManagement KeyでTapを作り、fh_で始まるTap TokenでRuleを登録してGET /v1/streamに接続します。接続は最長300秒で閉じるので、Last-Event-IDを付けて再接続する作りが前提です。 - ルールは既定で公開7日以内に絞られ、ページ番号付きURL・タグやカテゴリの一覧・クエリ付きURLが除外されます。
POST /v1/validateで保存前に展開結果を確認できます。 - 公式ドキュメントのNode.jsサンプルはeventsourceパッケージ2系の書き方で、2026年11月時点の最新5.1.5ではそのままでは動きません。
Ahrefs Firehoseの仕組みとベータ公開からの変化
処理はルール作成、クロール済みページとの照合、一致したページの配信という流れです。AhrefsBotが新しく取得したページを各Tapに登録された全ルールと照合し、どれか1つに一致すれば「マッチ」としてストリームとダッシュボードへ流します。データ源はSite ExplorerやContent Explorerと同じAhrefsのWebインデックスで、Ahrefsの製品ページはクロール量を毎分500万ページと表示しています。
2026年3月のベータ公開から有料プラン化までの経緯
国内向けのプレスリリースでは、Firehoseは2026年3月17日に公開され、ベータ期間中は無料・クレジットカード登録不要とされていました。その後、Ahrefs公式ブログがJune ’26の新機能まとめ(2026年7月31日公開)でFirehoseを独立した新製品として紹介し、料金がAhrefsのサブスクリプションとは別だと明記しています。
ベータ時点の解説で広まった「1組織あたりルール最大25件」は、現行の料金ページでは「Unlimited rules per monitor」に置き換わりました。25という数字は、今はAdvancedプランのTap数として残っています。古い記事の制約値を設計に使わないでください。
有料化した後も、利用規約(2026年3月6日改訂)の8.1条はFirehoseのサービス全体を「wholly beta products」と定め、稼働時間・性能・可用性の保証を否認しています。稼働率を数値で約束するSLAは公表されていません。
Amazon Data Firehoseとの名前の重なり
「firehose」で検索すると、AWSのAmazon Data Firehose(旧Kinesis Data Firehose)の情報が多く出てきます。こちらは自社のログやイベントをS3やRedshiftへ送るデータ転送基盤で、Webページの変化を監視するAhrefs Firehoseとは目的も提供元も違います。AWS側を調べている場合はAmazon Data Firehoseの仕組みと料金の解説を参照してください。
StreamとURL Watchの違いと使い分けの基準
公式ドキュメントは、2つの違いを「どのページを確認するかを誰が決めるか」の一点にまとめています。Streamはクローラーが自分の予定で到達したページを評価し、URL Watchは指定したURLを指定した間隔で取りに行きます。
| 項目 | Stream | URL Watch |
|---|---|---|
| 監視対象 | Web全体(パターン一致) | 指定したURLの一覧 |
| 設定するもの | TapとRule(クエリ) | URLと確認間隔 |
| 確認のきっかけ | クローラーの到達 | 指定した間隔 |
| 受け取り方 | SSEとダッシュボード | 差分付きのクロール履歴 |
| 課金単位 | マッチ数 | 月間チェック数 |
ブランド名や競合名の言及を広く拾うならStream、競合の料金ページや利用規約のように場所が分かっているページの変更を追うならURL Watchです。
url:ルールの絞り込み対象と再クロールの制約
Streamのルールにurl:"https://example.com/pricing"と書いても、Firehoseがそのページを取りに行くわけではありません。url:は「クロールされたページのうちどれを一致とみなすか」を絞る条件で、クローラーが再訪しなければ変更は届きません。後述のURLリストも同じで、公式ドキュメントはこれを通知が来ない原因の代表例に挙げています。特定ページを確実に追うならURL Watchに切り替えます。
URL Watchの確認間隔の下限はFreeが3時間、Starterが10分、AdvancedとBusinessが5分です。1回のクロールが1チェックで、相手が200以外を返すと次のクロールが先送りされ、チェック数の消費が抑えられます。ただし応答を受け取ったクロールは1チェックに数えられるので、障害中のサイトでも枠は減ります。月間上限に達するとウォッチは一時停止し、翌月にリセットされても自動では再開しないので、各ウォッチの詳細画面から戻す必要があります。
マッチを要約するSmart Digest(ベータ・無料)
Smart Digestは、トピックを指定するとエージェントがルールを書き、マッチを取捨選択して1本のレポートにまとめる機能です。更新間隔は1時間、6時間、12時間、毎日、毎週から選べ、レポートは直近200件まで履歴に残ります。ベータ期間中、エージェントによる読み取りとレポートの更新はクレジットもプランのマッチ枠も消費しません。ただし利用者が専用Tapのフィードを開く・エクスポートする・APIで受信する分は通常どおり計量されます。また、Digestごとに専用のTapを1つ使うので、Freeプラン(Tap上限1)では既存のTapを一時停止しないと作れません。ダッシュボードの機能のため、API onlyプランでは使えません。
共有リンクを発行すると、Firehoseのアカウントがない人も現在のレポートと過去の履歴を読めます。共有ページにはnoindexが付きますが、リンクを知っていれば誰でも全履歴を読めるため、社外秘の競合分析を共有するときは扱いに注意してください。メール通知は既定でオフです。
Ahrefs Firehoseの料金プランと課金の仕組み
Firehoseの料金はAhrefs本体のLite〜Enterpriseの契約とは独立しており、Ahrefs APIのユニットも消費しません。2026年11月12日時点の料金ページとプラン一覧のドキュメントの内容は次のとおりです。
| プラン | 月額 | Tap数 | 確認可能マッチ/月 | URL Watch上限 | 月次APIクレジット |
|---|---|---|---|---|---|
| Free | $0 | 1 | 200 | 5URL・1,000回 | なし |
| Starter | $39 | 5 | 2,000 | 50URL・25,000回 | $10 |
| Advanced | $89 | 25 | 10,000 | 250URL・75,000回 | $50 |
| Business | $299 | 100 | 40,000 | 1,000URL・200,000回 | $200 |
| API only | 従量 | 無制限 | 対象外 | 利用不可 | 都度チャージ |
どのプランもTapあたりのルール数は無制限です。マッチの保存は有料プランだけの機能です。新規の組織には1回限り$5分のクレジットが付きます。有料プランとAPI onlyの間を直接は移れず、一度Freeを経由します。
ダッシュボード・URL Watch・APIで別々に減る3つの枠
課金で混乱しやすいのは、同じマッチでも見る場所によって減る枠が違う点です。課金の説明ページによると、ダッシュボードのフィードで確認したマッチはプランの「確認可能マッチ/月」から、URL Watchのクロールは「月間チェック数」から、GET /v1/streamで受け取ったマッチはプリペイドのクレジットから減ります。APIのマッチは1件$0.005で、同じページの再配信は重複課金されません。
クレジットが0になると、新しいストリーム接続はHTTP 402で拒否されます。超過分を自動請求する仕組みがないので請求額は膨らみませんが、月の途中で配信が止まる前提で残高を監視しておく必要があります。Starterに付く月$10のクレジットはちょうど2,000マッチ分で期間末に失効し、追加チャージ分は失効しません。
APIでリアルタイムデータを受け取る手順
AhrefsのAPIでWebの新着ページをリアルタイムに受け取るには、Ahrefs API v3ではなくFirehoseのAPI(ベースURLはhttps://api.firehose.com)を使います。手順はManagement Keyの発行、Tapの作成、Ruleの登録、ストリームへの接続の4段です。自社の業務システムやデータ基盤へ取り込む連携の設計が必要な場合は、API開発・システム連携の支援も行っています。
Management KeyとTap Tokenの権限の違い
キーは2種類あり、どちらもAuthorization: Bearerヘッダーで渡します。
| キー | 接頭辞 | できること |
|---|---|---|
| Management Key | fhm_ | Tapの作成・一覧・更新・一時停止・失効 |
| Tap Token | fh_ | そのTapのRule管理・クエリ検証・ストリーム接続 |
Management KeyはRuleの操作もストリーム接続もできません。一方でGET /v1/tapsは全Tapのトークンを返すため、Management Keyが1本漏れれば全Tapのストリームを読まれます。Management Key自体は作成時に一度しか表示されないので、シークレット管理の対象にしてください。
curlでTap・Ruleを作りストリームを受信する手順
# 事前に発行したManagement Keyを設定
export FIREHOSE_MGMT_KEY='fhm_your_management_key'
# 1. Tapを作成。応答に含まれるTap Tokenを控える
curl -s -X POST https://api.firehose.com/v1/taps \
-H "Authorization: Bearer $FIREHOSE_MGMT_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "brand-mentions"}'
export FIREHOSE_TAP_TOKEN='fh_your_tap_token'
# 2. Ruleを登録(Tap Token)。本文の追加部分に "issoh" を含み、24時間以内に公開されたページ
curl -s -X POST https://api.firehose.com/v1/rules \
-H "Authorization: Bearer $FIREHOSE_TAP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"value": "issoh AND recent:24h", "tag": "brand"}'
# 3. ストリームを開く(60秒で切れる設定)
curl -N "https://api.firehose.com/v1/stream?timeout=60" \
-H "Authorization: Bearer $FIREHOSE_TAP_TOKEN"
接続すると最初にconnectedイベントが届き、その後マッチごとにupdateイベントが流れます。updateのdataには一致したルールのID(query_ids)とdocumentが入ります。documentで必ずあるのはURLだけで、タイトル・公開日時・言語・分類ラベル・ドメインのDRは値がある場合だけ含まれ、空の項目はnullではなくキーごと省かれます。クエリでpage_typeと書く分類はペイロードではpage_types、drはdomain_ratingという名前で届くので、受信側は名前の違いと項目の有無を確かめてから読みます。本文は全体ではなく、一致した変更部分だけがdiff.chunks(insが追加、delが削除)で届きます。ルールが1つもないTapに接続するとHTTPは200のまま、errorイベントで「No rules configured」が返ります。
切断と再開の仕様(timeout 300秒・Last-Event-ID・24時間バッファ)
ストリームの仕様では、timeoutは1〜300秒(既定300秒)で、時間が来るとendイベントを送って閉じます。limit(1〜10,000件)を指定した場合も、その件数で閉じます。続きを受け取るには、最後に受けたupdateのid:をLast-Event-IDヘッダーに入れて再接続します。
配信済みイベントは約24時間バッファされ、再開位置はLast-Event-ID、offset、since(最大24h)、最新位置の順に優先されます。24時間を超えて止まっていたクライアントは、その間のマッチを取り戻せません。レート制限はTapごとに/v1/streamが毎分30接続、/v1/rulesが毎分60リクエストで、待機なしで再接続を繰り返すとすぐ429に当たります。
Python標準ライブラリだけで再接続まで行う受信コード
公式のPythonサンプルは1回の接続でURLを表示するだけで、end後の再接続とLast-Event-IDの引き継ぎがありません。次のコードはその2点に加え、CRLF改行と複数行のdataへの対応、処理済みイベントIDの保存(一時ファイルからos.replaceで差し替え)、errorイベントでの停止、途中切断からの再接続を足したものです。IDはupdateを処理し終えてから保存するので、処理中に落ちてもそのイベントから再開できます。
import http.client, json, os, time, urllib.request, urllib.error
URL = "https://api.firehose.com/v1/stream?timeout=300"
TOKEN = os.environ["FIREHOSE_TAP_TOKEN"]
STATE = "last_event_id.txt" # 再起動後も再開位置を引き継ぐ
class StreamError(Exception):
pass
def load_id():
return open(STATE).read().strip() if os.path.exists(STATE) else None
def save_id(event_id):
tmp = STATE + ".tmp"
with open(tmp, "w") as f:
f.write(event_id)
os.replace(tmp, STATE) # 書き込み途中で落ちても直前のIDを失わない
def handle(doc):
print(doc["url"], doc.get("title", "")) # ここを通知やキュー投入に置き換える
def stream_once():
headers = {"Authorization": f"Bearer {TOKEN}"}
last_id = load_id()
if last_id:
headers["Last-Event-ID"] = last_id
req = urllib.request.Request(URL, headers=headers)
event, data, event_id = "message", [], None
# サーバー側の300秒より長いタイムアウトで、無応答の通信に固まらないようにする
with urllib.request.urlopen(req, timeout=330) as resp:
for raw in resp:
line = raw.decode("utf-8").rstrip("\r\n")
if line == "":
if event == "update" and data:
handle(json.loads("\n".join(data))["document"])
if event_id:
save_id(event_id)
elif event == "error":
# ルール未登録などはHTTP 200のままerrorイベントで届く
raise StreamError("\n".join(data))
elif event == "end":
return
event, data, event_id = "message", [], None
continue
name, _, value = line.partition(":")
if value.startswith(" "):
value = value[1:]
if name == "id":
event_id = value
elif name == "event":
event = value
elif name == "data":
data.append(value)
while True:
try:
stream_once()
time.sleep(3) # 再接続を毎分20回以下に抑える(上限の毎分30接続はTap単位で、他の接続と合算される)
except urllib.error.HTTPError as e:
if e.code in (401, 402):
raise
time.sleep(5)
except (urllib.error.URLError, OSError, http.client.IncompleteRead):
time.sleep(5) # 接続失敗・途中切断は待って再接続
このコードは、Authorizationヘッダーを検査してconnected・update・endを返すローカルのSSEサーバー相手に、Python 3.9.6で2026年11月12日に動作を確かめました。サーバーより先に起動しても再試行で接続し、2回目以降の接続に直前のIDがLast-Event-IDとして付くこと、CRLF区切りと2行に分かれたdataを読めること、errorイベントでStreamErrorを出して止まること、不正なトークンではHTTPError 401で止まることを確認しています。チャンク転送の途中で接続を切るテストでは、http.client.IncompleteReadを捕捉しない版はその場で終了し、この版は5秒後に直前のIDから再開しました。errorを無視すると、ルール未登録のTapへ接続と切断を繰り返して429に当たります。保存先のファイルは複数のプロセスで共有しないでください。
Node.jsの公式サンプルがeventsource v5で動かない点と修正
公式のコード例はimport EventSource from 'eventsource'と書き、コンストラクタのheadersオプションでトークンを渡しています。これはeventsourceパッケージ2系の書き方です。2026年11月8日公開の最新5.1.5をNode.js 26.5.0で実行すると、「does not provide an export named ‘default’」で起動しません。名前付きインポートに直してもheadersは無視されて認証ヘッダーが付かず401となり、5系は401では自動再接続しないため1回で閉じます。5系ではfetchオプションでヘッダーを足します。対応ランタイムはNode.js 22.12以降です。
import { EventSource } from 'eventsource'; // npm install --save-exact [email protected](Node.js 22.12以降)
const token = process.env.FIREHOSE_TAP_TOKEN;
if (!token) throw new Error('FIREHOSE_TAP_TOKEN is required');
const es = new EventSource('https://api.firehose.com/v1/stream', {
fetch: (input, init) =>
fetch(input, { ...init, headers: { ...init.headers, Authorization: `Bearer ${token}` } }),
});
// 5系の再接続待ちタイマーはプロセスを保持しないため、明示的に保持する
const keepAlive = setInterval(() => {}, 60_000);
es.addEventListener('update', (e) => {
const { query_ids, document } = JSON.parse(e.data);
console.log(e.lastEventId, query_ids.join(','), document.url);
});
es.addEventListener('error', (e) => {
// サーバーが送るevent: error(ルール未登録など)はdataを持つ。再接続を止める
if (e.data !== undefined) {
console.error('stream error:', e.data);
es.close();
clearInterval(keepAlive);
return;
}
// 401や402などHTTPエラーでは自動再接続せずCLOSEDになる
if (es.readyState === EventSource.CLOSED) {
console.error('stream closed:', e.code ?? '', e.message ?? '');
clearInterval(keepAlive);
}
});
上のPythonと同じローカルSSEサーバーで、5.1.5でも確かめました。setIntervalがないと最初のendの後に再接続せずプロセスが終了し、この形なら9秒間に3回接続して2回目以降に直前のIDが自動で送られ、不正なトークンでは「stream closed: 401」を出して閉じました。ルール未登録を示すerrorイベントを送るサーバーに対しては、dataを見る分岐がない版が7秒間に3回、何も表示せずに再接続を繰り返し、この版は1回目でメッセージを表示して止まりました。ブラウザ標準のEventSourceは独自ヘッダーを送れないため、フロントエンドから直接Tap Tokenで接続することはできません。トークンをブラウザに置かないためにも、サーバー側で受けて中継します。SSEとWebSocketの使い分けはSSE(Server-Sent Events)の仕組みと実装の解説で比較しています。
ルールのクエリ構文とpage_category・page_typeの指定
ルールのvalueはLucene互換の構文で書きます。フィールドを付けない語はadded(ページに新しく追加されたテキスト)を検索するため、既存ページの本文全体ではなく「今回の更新で増えた部分」だけが対象になる点が、一般的な全文検索と違います。
使えるフィールドと大文字小文字の扱い
| フィールド | 型 | 内容 |
|---|---|---|
| added(既定) | テキスト | 追加された本文 |
| removed | テキスト | 削除された本文 |
| added_anchor | テキスト | 追加されたリンクのアンカー |
| removed_anchor | テキスト | 削除されたリンクのアンカー |
| title | テキスト | ページタイトル |
| url / domain | キーワード | URL全体 / ドメイン |
| publish_time | キーワード | 公開日時(ISO 8601) |
| page_category / page_type | キーワード | 機械学習による分類ラベル |
| language | キーワード | 検出言語コード |
| dr | 数値 | ドメインのDR(0〜100) |
| recent | フィルタ | 公開からの経過時間 |
テキスト型は小文字化されるので大文字小文字を区別しませんが、キーワード型は完全一致で区別します。domain:"Example.com"はexample.comに一致しません。urlはワイルドカードと正規表現、domainはワイルドカードまで使え、スラッシュは\/とエスケープします(JSONの中では\\/)。DRの範囲はdr:[50 TO *]と書き、dr:>=30は「Invalid numeric value」で弾かれます。
page_categoryとpage_typeの一覧と書き方
分類ラベルは/Newsや/Article/How_toのようにスラッシュで階層を表す固定の語彙です。page_typeの上位は/Listing、/Listing_Collection、/Article、/Landing_Page、/Interactive_Tools、/Image、/Video、/Audio、/Document、/User_Generated_Content、/Core_Pageの11系統です。下位の全ラベルとpage_categoryの全一覧はMatch payloadのページにあります。
カテゴリの総数はドキュメント内で食い違っています。Rulesのページは「上位25・下位700超」、Match payloadのページは「上位27・下位1,067」と書いており、ここでは全ラベルが載っている後者に従います。値はスラッシュで始まるので必ず引用符で囲みます。page_type:/Articleのように囲まないと正規表現の開始と解釈され、検証APIは構文エラー(Lexical error)を返しました。
既定ONのqualityフィルタが足す除外条件
ルールにはquality(既定true)とnsfw(既定false)の2つのフラグがあり、クエリではなくルールのJSONに書きます。公開版の検証APIにtesla AND language:enを送ると、実際にマッチャーへ渡る条件(effective_lucene)は次のように展開されました。
+(+added:tesla +language:en) #age_seconds:[0 TO 604800]
-url:/.*/page/[0-9]+.*/ -url:*/category/* -url:*/categories/*
-url:*/tag/* -url:*/tags/* -url:/.*\?.*/ -page_category:/Adult
604800秒は7日です。qualityが有効だと公開7日以内のページに限られ、/page/2のようなページ送り、/category/・/categories/・/tag/・/tags/を含むURL、?付きのURLが落ちます。{"quality": false}にすると7日とURLの除外が消え、-page_category:/Adultだけが残ります(これはnsfw側の除外です)。古い記事の追記や、パラメーター付きURLで記事を出すサイトを狙うルールで何も来ないときは、まずこのフラグを疑ってください。
POST /v1/validateによる保存前のクエリ検証
POST /v1/validateは、ルールを作らずにクエリを検査するエンドポイントです。マッチャーと同じエンジン(query-core)で処理するので、valid: trueなら保存後も同じ条件で照合されます。Tap Tokenが必要ですが、$filter参照を使わないクエリなら認証不要のPOST /v1/validate/publicでも同じ形の応答が返ります。
curl -s -X POST https://api.firehose.com/v1/validate \
-H "Authorization: Bearer $FIREHOSE_TAP_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query": "issoh AND language:ja", "quality": true}'
2026年11月12日に公開版で試した結果は次のとおりです。language:engは「Did you mean ‘en’?」の警告とunmatchable_queryエラーでvalid: false、page_type:"/Articel"のような綴り誤りも最も近い/Articleが提示されてvalid: false、NOT domain:example.comのように除外条件だけのクエリもvalid: falseでした。一方、domain:"Example.com"は警告なしでvalid: trueになります。検証APIが見るのは構文と語彙で、大文字小文字の誤りによる「一致ゼロ」は検出しません。
ブランド監視・被リンク・求人の実務クエリ例
# 自社名を含む新着記事(DR50以上のドメインに限定)
"issoh" AND page_type:"/Article" AND dr:[50 TO *]
# 自社名を含むアンカーテキストが追加されたページ(自社への被リンクかはリンク先を確認)
added_anchor:issoh AND NOT domain:www.issoh.co.jp
# 競合ドメインの新しい料金・プラン関連ページ(タグ・カテゴリ一覧はqualityが既に除外)
domain:example.com AND url:*\/pricing*
# 求人ページの新着(採用強化のシグナル)
title:"now hiring" AND page_type:"/Listing_Collection/Job"
4本とも公開版の検証APIでvalid: trueを確認しています。SEO担当者に実用性が高いのはadded_anchorで、自社名を含むアンカーテキストの追加を、クローラーがそのページを取得した時点で検知できます。ただしリンク先が自社サイトとは限らないため、被リンクかどうかはupdateのURLを開いて確かめます。addedに自社名があってadded_anchorにない場合も、別表記のアンカーや以前からのリンクがありうるので、リンク依頼の候補にする前にページ上のリンクを確認してください。
ルールが増えたときの共通化とAIアシスタントからの操作
Tapやルールが10本を超えると、同じ除外条件を各ルールに貼り直す保守が負担になります。Filters & domain listsのページには、その重複をまとめる機能が載っています。
フィルターの$参照とドメイン・URLリスト
クエリフィルターは名前付きのクエリ断片で、no-junkという名前で定義すれば、ルールからtitle:tesla AND $no-junkのように参照できます。フィルターから別のフィルターは参照できません。ドメインリストとURLリストは値の集合で、Tapに「Include(そのドメインだけに一致)」か「Exclude(そのドメインには一致させない)」として付けると、Tap内の全ルールに効きます。1組織あたりフィルターは50個、リスト型は1つあたり5,000件までです。URLリストもクロールを予約するものではない点は、url:ルールと同じです。
組織全体の除外ドメインとAIによるクエリ生成
除外ドメイン(Excluded domains)は組織単位のブロックリストで、全Tapの全ルールに適用されます。コンテンツファームやアグリゲーターを一度登録すれば、各ルールにNOT domain:を書かずに済みます。インポートとエクスポートはGoogleの否認(Disavow)ファイル形式にも対応しているので、SEOで使っている否認リストをそのまま流用できます。1つのTapだけで外したいなら、除外ドメインではなくExcludeモードのドメインリストを使います。
ルールやフィルターの編集画面の「Generate query」は、「英語の電気自動車ニュースで直近1日、ページ送りを除く」のような説明から検証済みのクエリと短い説明を生成します。公式も下書きとして扱うよう書いているので、生成結果は前述の検証APIと、数日分の実際のマッチで確かめてから本番に使ってください。
AIアシスタントにAPIを扱わせるskill.mdとllms-full.txt
Ahrefsの製品ページは配信方法に「AIアシスタント経由」を挙げており、そのための資料がドキュメント側に用意されています。全ページを1ファイルにまとめたhttps://docs.firehose.com/llms-full.txt、各ページのURLに.mdを付けたMarkdown版、全エンドポイント・クエリ文法・分類ラベルを1ファイルにした/skill.mdです。公式は、概念の説明としてllms-full.txt、API操作の根拠としてskill.mdをエージェントに渡す使い方を勧めています。llms-full.txtは2026年11月12日時点で約150KBあり、curlで取得できました。Ahrefs本体のデータをAIアシスタントから引く仕組みはAhrefs MCPの設定と料金の領域で、Firehoseとは契約も課金も別です。MCPそのものの仕組みはMCP(Model Context Protocol)の解説を参照してください。
GoogleアラートやSNS監視ツールと比べた採用判断
Ahrefsの製品ページはGoogleアラートとの比較表で、Googleアラートの通知を「毎日または毎週のメールダイジェスト」、フィルタリングを「キーワードのみ」と書いています。しかしGoogleアラートの設定画面には頻度「その都度」があり、Googleのヘルプも頻度・サイトの種類・言語・地域・件数を変更できると説明しています。比較表だけで乗り換えを決めるのは避けてください。
実際の差は、絞り込みの粒度と取り込み先です。FirehoseはDR・ページ種別・公開からの経過時間・アンカーテキストの変化まで条件にでき、結果をAPIで自社システムへ流せます。Googleアラートで条件にできるのはキーワード演算子と上の5項目までで、受け取りはメールが基本です。
Firehoseを選ばないほうがよい条件
- 監視したい語が月に数件しか出てこず、メールで読めば足りる場合。Googleアラートの「その都度」で間に合い、費用もかかりません。
- X(旧Twitter)やInstagramの投稿が主な監視対象の場合。Ahrefsが挙げる用途はニュースサイト・ブログ・フォーラムでの言及で、SNS投稿をどこまで拾えるかは公表されていません。感情スコアの集計やインフルエンサーの影響度分析もドキュメントにないので、それが要件ならソーシャルリスニング専用ツールが向いています。
- 通知の欠落が業務事故になる場合。利用規約上はベータ扱いでSLAがなく、受信側が24時間以上止まればマッチは回収できません。重要な監視は既存ツールを残したまま並行運用し、検知漏れを比べてから切り替えてください。
反対に、DRや分類ラベルで絞り込んだ言及を社内のSlackやデータ基盤へ自動で流したいチームなら、Freeプランの1 Tapと、新規組織に一度だけ付く$5分(1,000マッチ分)のAPIクレジットで検証を始められます。Freeの月200マッチはダッシュボードで確認する枠で、APIでの受信には使えません。
よくある質問
Ahrefs Firehoseとは何ですか?
Ahrefsが提供するリアルタイムのWeb監視サービスです。AhrefsBotがクロールしたページを、利用者が登録したルール(Lucene互換のクエリ)と照合し、一致したページをSSEのストリームやダッシュボードへ届けます。ブランドや競合の言及、新着ニュース、新しい求人ページなどの検知に使われます。指定したURLを定期的に再クロールして差分を記録するURL Watchも含まれます。Ahrefs本体(Site Explorerなど)とは別の製品で、契約も別です。
Ahrefs Firehoseは無料で使えますか?
Freeプランは月額$0で、Tap1つ、ダッシュボードで確認できるマッチが月200件、URL Watchが5URL・月1,000回まで使えます。クレジットカードの登録は不要で、新規の組織には$5分のAPIクレジットが1回だけ付きます。それ以上はStarter($39/月)、Advanced($89/月)、Business($299/月)か、API専用の従量課金(1,000マッチあたり$5)です。2026年3月の公開当初の「ベータ期間は無料」という情報は、現在の料金体系とは異なります。
AhrefsのAPIでリアルタイムデータを取得する方法は?
Ahrefs API v3は集計済みの指標を取るためのもので、新着ページのリアルタイム取得はFirehoseのAPIで行います。firehose.comでManagement Key(fhm_)を作り、POST /v1/tapsでTapを作成し、返ってきたTap Token(fh_)でPOST /v1/rulesにルールを登録します。その後GET /v1/streamにSSEで接続すると、一致したページが届きます。接続は最長300秒で切れるので、Last-Event-IDを付けて再接続する実装にしてください。
Ahrefs Firehoseのpage typeの一覧はどこで確認できますか?
公式ドキュメント(docs.firehose.com)の「Match payload」ページの「Category and type labels」に、page_typeとpage_categoryの全ラベルが掲載されています。page_typeの上位は/Article、/Listing_Collection、/Documentなど11系統で、/Article/How_toのように階層を持ちます。ルールではpage_type:"/Article"のように引用符で囲み、綴りに自信がなければPOST /v1/validateで確かめます。
Firehoseを使うとAhrefs APIのユニットは減りますか?
減りません。FirehoseはAhrefsのサブスクリプションとは別に課金される独立した製品で、ストリームのマッチはFirehose側のプリペイドクレジット、ダッシュボードとURL Watchはプランの月間枠から差し引かれます。Ahrefs本体をLiteやStandardで契約していても、Firehoseの枠は増えません。Firehoseだけを契約してAhrefs本体を使わない運用もできます。