us-congress-trades

🏛️ Congress Trading API：米国議会議員の株式取引と開示情報をクリーンな JSON で

Congress Trading API を最も効率的かつ確実に、開発者に使いやすい形で利用できます。

アクターページ： apify.com/johnvc/us-congress-financial-disclosures-and-stock-trading-data 入力スキーマ： apify.com/johnvc/us-congress-financial-disclosures-and-stock-trading-data/input-schema

Congress Trading API は、米国議会の定期取引報告書（PTR）を、クリーンで構造化された JSON として返します。各行は開示された取引を1件表し、議員名と議院、州と選挙区、資産とティッカー、取引の種類、報告された金額の範囲、取引日と通知日、所有者、提出書類の ID が含まれます。議員名、ティッカー、特定の日付、または日付範囲で絞り込めます。データは、STOCK Act に基づく米国下院および上院の公式財務開示書類を正規化したものです。

動画での解説

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー（こちらから無料キーを取得）

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-Congressional-Trading-Data-Scraper.git
   cd Apify-Congressional-Trading-Data-Scraper
   

2. UV で依存関係をインストールする

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. API キーを設定する

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. サンプルを実行する

   uv run python congress-stock-trades-scraper.py
   

代替方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python congress-stock-trades-scraper.py

Congress Trading API を使う理由

両院のデータを共通のスキーマで。 下院と上院の定期取引報告書を、クエリ可能な単一の形式に正規化しているため、2つの提出システム用に別々のパーサーを用意せず、議会全体を分析できます。

強力なフィルター。 議員の名または姓、株式ティッカー、特定の取引日、または日付範囲で絞り込めます。条件を組み合わせて、「この議員が2024年に行ったすべての NVDA 取引」といった質問にも答えられます。

監査に対応した構造化 JSON。 取引ごとに1行で、報告された金額の範囲を提出書類どおりに記録し、追跡可能で再現性のあるデータ取得のために提出書類と文書の ID、および実行ごとの検索メタデータも含みます。

予測しやすい従量課金。 料金は実行ごとと返却された取引ごとに発生し、月額料金はありません。Max_Results でコストを直接管理できます。

自動化も簡単。 Python から数行で呼び出すことも、MCP ツールとして読み込むこともできます。Claude や Cursor などのアシスタントが、必要に応じて議会議員の取引情報を取得できます。

特長

主な機能

• 議員、ティッカー、または日付で絞り込み（特定の日付または日付範囲）
• 両院に対応：下院と上院の提出書類を1つのデータセットに収録
• 株式、オプション、ETF、投資信託、債券、暗号資産などの資産タイプ
• 議員、配偶者、扶養する子ども、または共同保有の所有者情報
• 購入、売却、オプション取引、株式取引向けの事前構築済みデータセットビュー

データ品質

• PTR の取引ごとに1行。議員、議院、資産、ティッカー、種類、金額の範囲、日付を含みます
• 金額の範囲は提出書類どおり（議員は正確な金額ではなく、金額の範囲を報告します）
• 提出書類と文書の ID。元の開示情報を追跡できます
• 実行ごとの検索メタデータ（タイムスタンプ、クエリの所要時間、結果数）。監査証跡に役立ちます
• 正規化済み。STOCK Act に基づく米国下院書記官および上院 eFD の公式提出書類をもとにしています

使用例

基本的な例

全議員の最新の開示情報です。API を最も低コストで試せる方法です。

{
  "Max_Results": 10
}

議員と日付範囲で絞り込む

指定した期間内に議員が開示したすべての取引です。

{
  "Last_Name": "Pelosi",
  "Start_Date": "2024-01-01",
  "End_Date": "2024-12-31",
  "Max_Results": 50
}

ティッカーで絞り込む

指定したティッカーを取引したすべての議員です。

{
  "Stock_Symbol": "AAPL",
  "Max_Results": 50
}

入力パラメーター

すべてのパラメーターは任意です。入力なしで実行すると最新の取引が取得されます。複数のフィールドを組み合わせると、結果を絞り込めます。

パラメーター	型	必須	デフォルト	説明
First_Name	string	いいえ	(なし)	会員の名（大文字と小文字を区別しない部分一致）。
Last_Name	string	いいえ	(なし)	会員の姓（大文字と小文字を区別しない部分一致）。
Date_Reported	string	いいえ	(なし)	正確な取引日。YYYY-MM-DD。期間を指定する場合は、代わりに Start/End を使用してください。
Start_Date	string	いいえ	(なし)	含める最も古い取引日（この日を含む）。YYYY-MM-DD。
End_Date	string	いいえ	(なし)	含める最新の取引日（この日を含む）。YYYY-MM-DD。
Stock_Symbol	string	いいえ	(なし)	ティッカーによるフィルター。例：AAPL、MSFT、NVDA（大文字と小文字を区別しない部分一致）。
Max_Results	integer	いいえ	100	1回の実行で返す最大行数（1～1000）。

出力形式

1件の取引が、単一のデータセット行として返されます。

{
  "id": "3b454411-9bfb-5545-8568-b14e596503e3",
  "Owner": "SP",
  "Asset": "Palo Alto Networks, Inc. (PANW)",
  "Ticker": "PANW",
  "Asset_Type_Code": "OP",
  "Transaction_Type": "P",
  "Date": "2024-02-21",
  "Notification_Date": "2024-02-21",
  "Amount_Range": "$100,001 - $250,000",
  "Capital_Gains_Over_200": "No",
  "Details": "Purchased 20 call options with a strike price of $200 and an expiration date of 1/17/25.",
  "First_Name": "Nancy",
  "Last_Name": "Pelosi",
  "State_District": "CA11",
  "House": "House",
  "Filing_ID": "20024542",
  "DocID": "20024542",
  "Year": "2024",
  "PDF_Quality": "text",
  "created_at": "2025-09-04T13:08:13.253936+00:00",
  "search_metadata": {
    "last_name": "Pelosi",
    "max_results": 100,
    "search_timestamp": "2025-09-05T11:08:47.827456",
    "total_results_found": 10,
    "query_execution_time": 5.30
  }
}

フィールドのリファレンス

フィールド	意味
Transaction_Type	P = 購入、S = 売却、S (partial) = 一部売却、E = 交換
Asset_Type_Code	ST 株式、OP オプション、MF 投資信託、BD 債券、ET ETF、CT 暗号資産
Owner	SP 配偶者、DC 扶養している子ども、JT 共同所有、空欄 = 会員本人
Amount_Range	報告額の範囲。例：$1,001 - $15,000。会員は正確な金額ではなく範囲を報告します
House	House または Senate
PDF_Quality	text（機械可読な提出書類）または image（OCR が必要な提出書類）

---

MCP ツールとして使用する

Congress Trading API を MCP ツールとして読み込むと、アシスタントから呼び出せるようになります。MCP サーバーの URL には、この Actor だけがあらかじめ読み込まれています。

https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data

ブラウザーに表示された場合は OAuth で認証するか、Apify API トークン（Python の例で使用するものと同じ APIFY_API_TOKEN）で認証してください。トークンは https://console.apify.com/settings/integrations で取得できます。また、無料の Apify アカウントは https://apify.com?fpr=9n7kx3 で作成できます。

Claude Cowork Desktop にインストールする

Cowork はデスクトップアプリの自動化モードです。Congress Trading API をツールとして使用するには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または Settings → Developer → Edit Config を選択して、claude_desktop_config.json を直接編集します）。
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. この Actor だけがあらかじめ読み込まれるように、Apify MCP サーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出す際は、ブラウザーで OAuth プロンプトを完了するか、コネクターの設定に Apify API トークンを追加して OAuth を省略してください。
4. Cowork のチャットでツールが利用可能であることを確認し、Congress Trading API の実行を依頼します。

デスクトップアプリをダウンロードして、無料トライアルを開始してください：https://claude.ai/referral/uIlpa7nPLg 詳しい説明：https://docs.apify.com/platform/integrations/claude-desktop

Claude Code にインストールする

Claude Code はコマンドラインツールです。1つのコマンドで Actor の MCP サーバーを追加できます。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data"

ブラウザーでの OAuth の代わりにトークンを使用するには：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

次に、claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Code に Congress Trading API の呼び出しを依頼してください。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude Code の MCP ドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストール

claude.ai では、Apify をコネクターとして追加し、この Actor のツールだけを有効にします。

1. Settings → Connectors → Browse connectors に移動し、Apify MCP server を検索します。インストールします（プロンプトが表示された場合は、有効化または更新します）。
2. 接続時に Apify API トークンで認証し、ツール johnvc/us-congress-financial-disclosures-and-stock-trading-data を有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選び、完全な MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data を貼り付け、プロンプトが表示されたら OAuth を使用します。
5. Claude に Congress Trading API の実行を依頼します。

ウェブで Claude を開く：https://claude.ai/referral/uIlpa7nPLg

Cursor にインストール

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data"
    }
  }
}

2. ブラウザー OAuth ではなくトークン認証を使う場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色のドット）を確認します。
4. Composer または Chat で、Cursor に Congress Trading API の呼び出しを依頼します。

Cursor は初めてですか？こちらから入手できます：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT にインストール

ChatGPT は Developer mode を通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education の各プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開き、Developer mode を有効にします。
2. Create app をクリックし、フォームに入力します。
   • Name: Apify
   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/us-congress-financial-disclosures-and-stock-trading-data
   • Authentication: OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャットで + をクリックし、Developer mode を選択して、Apify を選びます。

詳しいヘルプ：https://docs.apify.com/platform/integrations/mcp

---

心を込めて作成

Congress Trading API を活用し、信頼性の高い構造化された結果で透明性、調査、コンプライアンスのワークフローを支援します。

🤖 この Actor について AI アシスタントに質問する

Congress Financial Disclosures API に関する、すぐに送信できるプロンプトをお好きな AI で開きます。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最終更新日：2026.10.27