FactReason

---

エージェントによる依存関係アップグレードの不具合を防ぐ

エージェントが chalk を 4.1.2 から 5.0.0 にアップグレードしようとしています。package.json を編集する前に、何が壊れるかを確認します。

GET /api/v1/packages/npm/chalk/advisory?from=4.1.2&to=5.0.0
Authorization: Bearer <key>

{
  "found": true,
  "packageName": "chalk",
  "fromVersion": "4.1.2",
  "toVersion": "5.0.0",
  "breakingCount": 2,
  "advisories": [
    {
      "severity": "breaking",
      "changeType": "MODULE_FORMAT_CHANGED",
      "description": "chalk 5.0.0 changed module format from \"commonjs (undeclared)\" to \"module\". CommonJS require() of this package will now fail.",
      "evidenceField": "type",
      "evidenceBefore": null,
      "evidenceAfter": "module",
      "migrationHint": "Convert the call site to import(), or pin to the last CommonJS release."
    },
    {
      "severity": "breaking",
      "changeType": "RUNTIME_REQUIREMENT_RAISED",
      "description": "chalk 5.0.0 raised its runtime requirement from \">=10\" to \"^12.17.0 || ^14.13 || >=16.0.0\". Older runtimes are no longer supported.",
      "evidenceField": "engines.node",
      "evidenceBefore": ">=10",
      "evidenceAfter": "^12.17.0 || ^14.13 || >=16.0.0",
      "migrationHint": "Confirm the deployment runtime satisfies the new floor before upgrading."
    }
  ]
}

MCP 経由なら、同じ質問はツール呼び出し 1 回で済みます。

{
  "name": "factreason_package_upgrade_advisory",
  "arguments": { "registry": "npm", "name": "chalk", "from": "4.1.2", "to": "5.0.0" }
}

対応する負荷の大きい MCP ツールで responseFormat: "compact" を設定すると、エージェントに必要な事実を保持したまま、繰り返されるフィールドや説明文を省略できます。パッケージの注意事項では、evidenceField、evidenceBefore、evidenceAfter、migrationHint が保持されます。各コンパクトレスポンスには、o200k_base でカウントした tokenMetrics が含まれます。互換性のため、デフォルトは引き続き full です。コンパクト出力によって認可が回避されたり、クエリ料金が変更されたりすることはありません。

トークンの削減量はレスポンスによって異なります。メトリクスは、正確な JSON structuredContent ペイロード 1 件をカウントし、tokenMetrics オブジェクト自体も含みます。まだ構造化コンテンツを利用しない MCP クライアント向けに、対応するテキストブロックも維持されます。非公開のアプリケーションリポジトリには、公開される削減量の主張をリリース前に検証できる、再現可能な npm run benchmark:tokens フィクスチャも含まれています。

すべての検出結果には、evidenceField、evidenceBefore、evidenceAfter が含まれます。これらは変更の前後における、レジストリメタデータの正確なフィールドと値です。エージェントは当社の言葉を鵜呑みにせず、npm または PyPI で直接主張を検証できます。

エージェントは factreason_create_key を呼び出せば、人間の手を借りず、カードも登録も不要で、すぐに自身のキーを取得できます。取得したキーは、任意の有料ツールの apiKey 引数として渡すことで、再接続せずに同じセッション内ですぐに使用できます。ヘッダーを設定できるクライアントであれば、代わりに MCP 接続の Authorization: Bearer ヘッダーにキーを指定できます。対象となる新規ユーザーには、付与上限の範囲内で、公開されているティア別料金に基づき最大 0.05 ドル分の初回限定トライアルクレジットが付与される場合があります。これは、注意事項の検索なら約 2 回、部品の検索なら 50 回分です。その後の成功した注意事項検索には、1 クエリあたり 0.02 ドルがかかります。検索が見つからなかった場合、料金は発生せず、トライアルクレジットも消費されません。ウォレットを備えたエージェントは、Base 上の x402 を使って 402 チャレンジに直接支払えます。

---

接続

Streamable HTTP。インストールも、取得するパッケージも不要です。

{
  "mcpServers": {
    "factreason": {
      "type": "http",
      "url": "https://factreason.com/mcp"
    }
  }
}

マニフェスト：/.well-known/mcp.json

人間向けのクイックスタートとワークフローのガイダンス：/docs。エージェントは同じ内容を /docs.md から Markdown 形式で取得することも、/llms-full.txt の完全なインデックスを利用することもできます。

コンテナー／stdio ブリッジは、オプションの FACTREASON_API_KEY 環境変数を受け取り、同じ稼働中のエンドポイントに Bearer 認証情報として転送します。ツールの検出にはキーは不要です。キーも有効な x402 支払いも指定されていない場合、従量制の検索は HTTP 402 を返します。

キーを取得 — 登録もカードも不要：

curl -X POST https://factreason.com/api/v1/keys/create \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]"}'

---

ツール

ツール	回答できる内容
factreason_package_upgrade_advisory	公開済みの npm/PyPI バージョン間で何が壊れるか
factreason_create_key	キーを作成します。有料ツールの apiKey 引数（または Bearer ヘッダー）に渡します
factreason_api_schema	特定バージョンにおける API エンドポイントの正確なリクエスト／レスポンス形式
factreason_api_breaking_changes	サードパーティの HTTP API のバージョン間で何が壊れるか
factreason_integration_brief	API 呼び出しを 1 つ正常に実行するために必要な情報
factreason_discover_api	1,097 のサービスのうち、どれが X を実行できるか
factreason_deprecation_scan	非推奨のエンドポイント、提供終了日、代替手段
factreason_auth_playbook	認証方式、スコープ、レート制限ヘッダー、エラーコード一覧
factreason_component_spec	電子部品のピン配置、電圧、パッケージ
factreason_subscribe_spec_changes	仕様変更時の Webhook またはポーリングコールバック
factreason_create_topup_link	クレジットがなくなった際の Stripe チェックアウトリンク

---

事実証明署名

REST データレスポンスおよび MCP ツール呼び出しのレスポンスが成功すると、当社の Ed25519 秘密鍵で署名されます。

• X-Warehouse-Proof-Signature：レスポンスペイロードの Ed25519 署名
• X-Fact-Public-Key-Id：安定した署名鍵識別子
• X-Fact-Signature-Alg：EdDSA

公開鍵は https://factreason.com/.well-known/jwks.json の JWKS を通じて公開・ローテーションされます。

---

ライセンスとお問い合わせ

MIT。APIs.guru のソースデータには、表示義務があります（CC-BY 4.0）。 ご質問、サポート、データに関する報告は、[email protected] までご連絡ください。