us-congress-trades

🏛️ 国会交易 API：以整洁的 JSON 获取美国国会议员股票交易和财务披露

使用 Congress Trading API 的最高效、可靠且对开发者友好的方式。

Actor 页面： 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 返回。每一行对应一笔披露的交易：议员姓名和所属院、州和选区、资产和股票代码、交易类型、申报金额范围、交易日期和通知日期、所有权以及申报 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？

两院数据，一套架构。 众议院和参议院的定期交易报告会规范化为统一、可查询的格式，因此你只需使用一个解析器，而不是分别处理两套申报系统，就能分析整个国会的数据。

强大的筛选功能。 可按议员名字或姓氏、股票代码、确切的交易日期或日期范围筛选。还可组合筛选条件，回答“这位议员在 2024 年进行的每一笔 NVDA 交易”这类问题。

适合审计的结构化 JSON。 每笔交易对应一行，包含申报中的原始金额范围，以及申报和文件 ID、每次运行的搜索元数据，确保查询可追溯、可复现。

可预测的按量付费定价。 费用按运行次数和返回的交易笔数计算，无月租费。你可以通过 Max_Results 直接控制成本。

便于自动化。 只需几行 Python 代码即可调用，也可以将其加载为 MCP 工具，让 Claude 和 Cursor 等助手按需获取国会议员交易数据。

功能

核心能力

• 按议员、股票代码或日期筛选（确切日期或日期范围）
• 涵盖两院：众议院和参议院的申报数据位于同一数据集中
• 资产类型包括股票、期权、ETF、共同基金、债券和加密货币
• 所有权归属涵盖议员、配偶、受抚养子女或共同持有
• 预构建的数据集视图，可查看买入、卖出、期权交易和股票交易

数据质量

• 每笔 PTR 交易对应一行，包含议员、所属院、资产、股票代码、类型、金额范围和日期
• 金额范围与申报内容完全一致（议员申报的是区间，而非确切金额）
• 申报和文件 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 到 1000）。

输出格式

每笔交易作为单个数据集行返回。

{
  "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 获取令牌，并在 https://apify.com?fpr=9n7kx3 注册免费的 Apify 账号。

在 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. 添加 Apify MCP 服务，并且只预加载此 Actor：

{
  "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 是命令行工具。使用一条命令添加 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 token 进行身份验证，并启用工具 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. 如果你更倾向于使用 token 身份验证，而不是浏览器 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，通过可靠、结构化的结果为透明度、研究和合规工作流提供支持。

🤖 向 AI 助手询问此 Actor

在你选择的 AI 中打开一条关于国会财务披露 API 的即用提示词：

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

最后更新：2026.10.27