本文へ移動
AGENT接続

これをAIFIND Agentに接続

三つの方法はすべて、同じデータ（厳選情報、注目トピック、日報、週報、月報）を参照します。お使いのツールに合わせてお選びください。いずれも匿名の読み取り専用で、登録やAPI Keyは不要です。MCP、RSS、API

サービス正常バージョン 4.0.0匿名・読み取り専用 · Key不要
MCPアドレスを入力すると、ツールが8個追加されますRSSURLをコピーしてリーダーで購読REST API匿名GETで、自作プログラムからデータを取得
REST API · 4.0.0

認証不要の GET、すぐに使えます

トークンは不要です。ブラウザーからのクロスオリジン通信、curl、各言語の標準 HTTP クライアントから直接呼び出せます。パスは /api/v1 です。フィールドとエラーコードは OpenAPI に準拠します。

最初のリクエスト
curl --compressed 'https://aifind.jp/api/v1/items?mode=selected&window=24h&limit=20'

カテゴリーで絞り込む

ニュースのリクエストに category を指定すると、そのカテゴリーのみ取得できます。省略すると全カテゴリーが対象です。返される各項目の category も下表の値を使用します。

カテゴリパラメーター
AIモデルcategory=ai-models
AIプロダクトcategory=ai-products
業界動向category=industry
研究category=paper
活用・解説category=tip
オピニオンcategory=opinion

通信量を抑えて、より高速に

  1. 01
    圧縮を有効化

    curl に --compressedを追加し、ほかのクライアントでは gzip または br を有効にします。JSON は圧縮すると元の 1/4～1/8 のサイズになります。

  2. 02
    ETag を付ける

    レスポンスの ETag を保存し、次回は If-None-Matchを付けます。内容に変更がなければ本文なしの 304 が返されます。

  3. 03
    適切な間隔で取得

    ニュースとトレンドの取得は最短1分間隔です。日報は毎日08:00の発行後、週報と月報も発行後に1回取得します。過去のページは取得済みの項目まで戻ったら終了してください。

ニュースは随時追加され、おすすめは1日に数回から数十回更新されます。日報は毎日08:00、週報は毎週月曜10:00、月報は毎月1日10:30（日本時間）にそれぞれ発行されます。

API 一覧

パス用途取得頻度
ニュース
/api/v1/items注目記事または直近7日間の全動向。カテゴリ、期間、キーワードで絞り込み可能最短1分間隔
注目トピックとイベント
/api/v1/hot-topics現在のホットトピック Top 10最短1分間隔
/api/v1/stories/{publicId}イベントの報道タイムライン、AIによる概要、関連イベント必要に応じて
日報
/api/v1/dailies/latest最新の日報毎日08:00 の発行後に1回
/api/v1/dailies/{date}指定日の報告。記事の撤回に伴い引用も削除キャッシュの有効期限が切れた後、使用前にETagを検証
/api/v1/dailies日報の日付インデックス1日1回
週報・月報
/api/v1/weeklies/latest最新の週報：見出し、概要、今週の注目情報をカテゴリ別に掲載毎週月曜10:00 の発行後に1回
/api/v1/weeklies/{week}週を指定（ISO週形式：2026-W39など）。記事の撤回に伴い引用も削除キャッシュの有効期限が切れた後、使用前にETagを検証
/api/v1/weeklies週報インデックス週1回
/api/v1/monthlies/latest最新の月報毎月1日10:30 の発行後に1回
/api/v1/monthlies/{month}月を指定（例：2026-09）キャッシュの有効期限が切れた後、使用前にETagを検証
/api/v1/monthlies月報インデックス月1回
モデルランキング
/api/v1/leaderboard/boards/overall総合ランキング最新の公開済み集計
/api/v1/leaderboard/models/:slugモデル詳細個別評価・設定・比較
/api/v1/leaderboard/catalogue出典と方法未集計時も利用可能
AIアシスタント向け
/api/v1/agentAgent向け利用ガイド。記載のURLから、整理済みの中国語版Markdownを取得できます必要に応じて
選定済みデータをすべて同期
/api/v1/selected/snapshot現在の選定済みデータをすべて取得（ページネーション）初回のみ
/api/v1/selected/changes以降の追加・変更・選定解除数分に1回

よくある使い方

bash
# 初回：レスポンスヘッダーのETagを保存
curl --compressed -i 'https://aifind.jp/api/v1/items?mode=selected&window=24h&limit=20'
# 以降：最短1分間隔でETagを付けてリクエスト。304が返された場合、変更はありません
curl --compressed -i -H 'If-None-Match: <前回のETag>' 'https://aifind.jp/api/v1/items?mode=selected&window=24h&limit=20'

前のページに戻る必要がある場合は、 page.nextCursor をcursorとして渡し、既に取得済みの項目に到達したら停止します。毎回7日分を取得し直さないでください。

エラーが発生した場合

400
パラメーターが不正な場合：OpenAPIとレスポンスのcodeに従って修正し、より広いクエリに自動で切り替えないでください。cursorが無効または有効期間外の場合はinvalid_cursorが返るため、最初のページからやり直してください。
409
snapshot_required：差分から安全に再開できません。完全なスナップショットを再取得してください。
429
リクエスト過多：Retry-Afterに従って待機し、同時に再試行しないでください。
5xx
指数バックオフを適用し、まず前回成功した結果を使用してください。公開サービスのSLAは保証されません。

匿名で呼び出せる場合でも、すべての用途が許可されているわけではありません。詳しくは利用規約。