BeliefState

BeliefState エージェント連携

エージェントを、出典付きの投資家の投資見解、投資リスク、カタリスト、調査の変更情報に接続できます。

• Gemini CLI： BeliefState アカウントを使用するリモート MCP 設定です。
• リサーチスキル： 株式や投資テーマに関する質問に答えるための検索ガイダンスです。
• HTTP の例： 無料の情報検索と署名なしの x402 見積もりに使用できる Postman コレクションです。
• リサーチ更新ワークフロー： 最新の企業スナップショットと順序付けされた調査変更情報を取得する、依存関係のない Node.js の例です。

クイックスタート

Gemini CLI がインストールされている場合：

gemini extensions install https://github.com/Antcolombo/beliefstate-agent-integrations

これにより、設定例がインストールされます。認証する前に、接続設定でクライアントの現在の利用可否を確認してください。 このパッケージでは、Gemini ネイティブの OAuth とリサーチの配信は検証されていません。拡張機能をインストールしたり、認証メタデータが表示されたりしても、アクセスできるとは限りません。Gemini が利用可能な場合は、/mcp auth beliefstate を実行してブラウザーでの同意を完了し、無料のカバレッジを確認してから、アカウントの利用枠またはクレジットを使ってリサーチをリクエストしてください。 サポート対象の方法として、公開済みの Claude コネクターを利用するか、既存の API キーを使用して以下の開発者向けワークフローを利用してください。 アカウント設定と料金をご覧ください。

企業調査の更新を実行する

Node.js 22 以降が必要です。依存関係のインストールは不要です。

サンプルを取得して、そのディレクトリに移動します。

git clone https://github.com/Antcolombo/beliefstate-agent-integrations.git
cd beliefstate-agent-integrations

認証情報やネットワーク呼び出しを使わずに、日付入りの公開調査サンプルを確認します。

npm run demo

日付入りのサンプルは、2026 年 10 月 27 日に検証された NBIS の実行内容を要約したものです。ソースリンク付きの現行ケースが 1 件、ジャーナルイベントが 7 件あり、意図的に 2 回の読み取り上限で停止しています。保留中の続行処理は、完了済みのポーリングチェックポイントとは別に保持されています。対象範囲、除外されたケース、未評価のフィールド、イベントのドメインが明示されています。サンプルにはアカウントの識別情報、認証情報、不可解なトークンは含まれていません。これは簡潔な結果の要約であり、API レスポンス全体でも最新の助言でもありません。

リクエストを一切行わずに、実際のワークフローを計画します。

node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z

調査の質問で指定した企業と基準日時を使用してください。実際のワークフローでは、無料で公開されている対象範囲を確認し、最大 3 件のケースを含む簡潔な現行スナップショットを読み取った後、その基準日時以降に確認された調査上の変更を順序どおりに記録したジャーナルを要求します。出力には、出典が明記された根拠、ソースリンク、イベントのドメイン、時刻、品質上の不足、履歴の対象範囲、除外事項、警告が保持されます。ジャーナルイベントは、エンジンによる評価、分配の変更、計算された結果の場合があります。著者による改訂として説明する前に、そのドメインを確認してください。

実際のアカウントにアクセスするには、シークレットストアから既存の BELIEFSTATE_API_KEY を読み込んでください。キーを作成したり、OAuth を接続したりしても、調査クレジットは追加されません。実行する前に、現在のアカウント料金と利用可能な残高を確認してください。

mkdir -m 700 .private
node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z \
  --execute --max-reads 2 --state .private/nbis-first.json > .private/nbis-first-output.json

出力をリダイレクトして .private に書き込む前に、mkdir -m 700 .private で .private を作成してください。出力をリダイレクトしない場合、スクリプトはプライベートな状態ディレクトリも作成します。返された調査データ、状態、チェックポイントは非公開に保ってください。キーは保存も表示もされません。所有者の診断には --test を使用してください。通常の顧客利用では指定しないでください。

--max-reads は、不確定なディスパッチを含め、その状態ファイルでのアカウント調査のディスパッチ総数に上限を設定します。10 月 27 日時点のアカウント従量課金レートでは、2 回の読み取りでクレジットを $0.08 使用します。プランの利用枠や従来のポリシーでは異なる場合があります。これは読み取り回数の上限であり、通貨額の使用許可ではありません。ウォレットを使った x402 のデータ読み取りには、別途 0.02 USDC の料金がかかります。このスクリプトはアカウント REST を使用し、ウォレット決済には署名しません。その方法については既存の x402 クイックスタートを参照してください。

ジャーナルに次のページがある場合、スクリプトは続行情報を保存して読み取り上限で停止します。同じ状態ファイルを使い、上限を最大 20 まで明示的に引き上げて、同じコマンドを再開してください。完了済みの結果はローカルで再利用されます。上限付きの現行スナップショットは自動的にページネーションされません。続行情報と除外フィールドは結果に残ります。

ジャーナルウィンドウの処理が完了した後、新しい状態ファイルを使って次のポーリングを開始します。

node examples/research-changes.mjs --ticker NBIS --previous-state .private/nbis-first.json \
  --execute --max-reads 2 --state .private/nbis-next.json

新しいウィンドウの読み取りがすべて完了するまで、古いチェックポイントは変更されません。resync_required、projection_catching_up、history_uninitialized には対応が必要です。これらは「変更なし」を意味するものではありません。このサンプルでは、不確定なディスパッチを復旧するために新しいリクエストを作成することはありません。アカウントのリクエスト ID により二重課金は防止されますが、完了したレスポンス本文は再生用に保持されません。状態を保持し、次の試行の前にリクエスト ID の照合をサポートに依頼してください。クラッシュ後に .lock ファイルが残っている場合は、削除する前に以前のプロセスが停止していることを確認してください。

npm test でオフラインの安全性チェックを実行します。

統合ファイル

ファイル	用途
gemini-extension.json	Gemini CLI をアカウントの OAuth MCP エンドポイントに接続します。
Research skill	投資家の見解を、出典、日付、根拠、制限事項とともに取得して説明します。
Postman collection	無料の検索リクエストと未払いの見積もりリクエストを Postman にインポートします。

このスキルは、互換性のあるクライアントのスキルディレクトリにコピーすることもできます。 手順を提供するものであり、ホストされたリサーチサービスへのアクセスは別途設定します。 クライアント独自のインストールおよび認証の管理機能に従ってください。

API を試す

以下のリクエストは無料で、アカウントやウォレットは不要です。

curl --fail-with-body https://beliefstate.ai/v1/research
curl --fail-with-body 'https://beliefstate.ai/v1/tickers?q=NBIS'
curl --fail-with-body https://beliefstate.ai/v1/research/get_belief

カタログには、16 個の有料リサーチツールと正確な料金が記載されています。14 個のデータツールは 0.02 USDC、比較ツールは 0.50 USDC、モデル支援検索は Base 上で呼び出しごとに 1.50 USDC です。Postman の見積もりリクエストは支払い要件を返しますが、支払いへの署名や送信は行いません。

接続方法

アクセス	エンドポイント	認証
アカウント MCP	https://beliefstate.ai/mcp	MCP クライアントを介した OAuth。
ウォレット MCP	https://beliefstate.ai/v1/research/mcp	互換性のある x402 ウォレットクライアントと、リサーチの読み取りに対する承認済みの支払い。
HTTP API	https://beliefstate.ai	アカウント API アクセスまたはカタログの x402 ルート。

最新のスキーマについては、OpenAPI 契約と MCP ドキュメントを参照してください。 認証情報は、クライアントのプライベートなシークレットストレージに保管してください。共有コレクションの変数には、アカウントの認証情報や支払い承認情報は含まれていません。

要件とサポート

Gemini CLI では、サポート対象のランタイムと OAuth 用のローカルブラウザーアクセスが必要です。 その他のクライアントでは、リモートの Streamable HTTP MCP または HTTP API のサポートが必要です。ウォレットアクセスには、BeliefState の x402 フローをサポートするクライアントが必要です。このパッケージに支払い署名機能は追加されていません。クライアント固有のサインインとライフサイクルの確認は、設定の検証とは別に行われます。

統合に関する問題は、このリポジトリで報告してください。アカウントまたはサービスに関する問題は、[email protected] までお問い合わせください。セキュリティ上の問題は、このメールアドレス宛てに非公開で報告してください。サービス情報：beliefstate.ai。

ライセンス

MIT は、Gemini の設定、コンテキスト、Postman コレクションに適用されます。 MIT は、ワークフローのコードにも適用されます。リサーチサンプルには、サービスのデータ利用規約と、明記された出典および制限事項が引き続き適用されます。 リサーチスキルは、フロントマターで宣言されているとおり、MIT-0 を使用します。ホストされたリサーチへのアクセスとデータには、BeliefState のサービス利用規約が適用されます。