trader-pelosi

trader-pelosi

美国国会议员必须申报自己、配偶和受抚养子女的交易。众议院书记官会将每份报告发布为 PDF，并按年份列在一个索引文件中。此工具会读取该索引，发现新报告出现时及时通知你，并为你读取报告。

它很快，但并不领先。议员须在得知交易后 30 天内提交 PTR，且最迟不得超过交易后 45 天，因此任何人看到报告时，交易早已过去数天或数周。这里没有内幕信息：只有公开文件，只是读取得快。每次都要说明这一点。

此文件夹中的工具（使用 Python 标准库；pdftotext 是 poppler 的可选组件，用于在本地读取 PDF）：

python3 "${CLAUDE_SKILL_DIR}/ptr.py" --help

读取和写入的内容

• 读取 https://disclosures-clerk.house.gov/public_disc/financial-pdfs/<YEAR>FD.zip（每份申报对应一个 <Member>：姓名、选区、FilingType、FilingDate、DocID），以及每份 PTR：.../public_disc/ptr-pdfs/<YEAR>/<DocID>.pdf。
• 写入 trader/state/pelosi.json（已显示过的 DocID，因此每份 PTR 只提醒一次），并将下载的 PDF 保存在 trader/state/ptr-pdfs/ 中。
• 读取 trader/portfolio.json（如果存在），以标记你持有的资产相关交易。

规则

• 引用申报文件，而非追踪网站。 每一行都来自书记官网站上的 PTR PDF，并附有其 DocID 和链接。第三方追踪网站适合浏览，但可能有误（Capitol Trades 显示的 Pelosi 交易日期比其 PTR 早一天）。以 PTR 为准。
• 金额是区间。 应写“$1,000,001 - $5,000,000”，绝不能写“$3 million”。
• 持有人很重要。 SP 表示配偶，JT 表示共同持有，DC 表示受抚养子女，空白表示议员本人。Pelosi 2026 年的交易全部标注为 SP：Paul Pelosi。
• 说明延迟。 每一行都显示交易日至申报日相隔多少天；超过 45 天则标记为逾期。
• 期权就是期权。 按执行价和到期日买入的看涨期权，不是股票买入。此工具会从描述中读取合约、执行价和到期日，并标记行权情况。

第 1 步：查看已提交的申报

python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member pelosi
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --since 2026-10-01        # every member
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member "Josh Gottheimer" --year 2025

--member 接受姓氏、“First Last”或“Last, First”，并可重复使用。 --type '' 会列出所有申报类型（年度报告的类型为 O）。

第 2 步：监视新申报

python3 "${CLAUDE_SKILL_DIR}/ptr.py" new --member pelosi --read

只显示上次检查后尚未见过的 PTR（首次运行时显示最近 45 天的记录），并通过 --read 下载和读取这些报告，然后将其记录到状态文件中。退出代码 1 表示没有新内容。一月份还会检查上一年的索引。书记官大约每天重建一次索引文件（2026-10-13 读取的副本显示当天 09:00 生成），因此工作日每小时检查一次就足够了：使用 /loop 1h 运行，或设置计划任务。

第 3 步：读取报告

python3 "${CLAUDE_SKILL_DIR}/ptr.py" fetch 20035143
python3 "${CLAUDE_SKILL_DIR}/ptr.py" parse ptr.txt --filed 2026-08-21 --json

fetch 会保存 PDF；如果已安装 pdftotext，还会打印各行内容。如果未安装，请打开保存的 PDF 直接阅读：你可以读取 PDF。parse 会将 pdftotext -layout 生成的文本转换为各行内容。如果报告跨越多页，请将行数与 PDF 核对。

示例：Reel 的提醒

NEW Periodic Transaction Report: Hon. Nancy Pelosi (CA11) filed 2026-08-21, doc 20035143
  - spouse purchase, Bloom Energy Corporation Class A Common Stock (BE): 100 call
    options, $100 strike, expires 2027-06-17, $1,000,001 - $5,000,000, traded
    2026-07-24, disclosed 28 days later

同一份 PTR 还显示了 10,000 股和 5,000 股 BE 股票、07/28 买入的另一笔 100 份 BE 看涨期权、Intel 股票和 50 份 Intel 看涨期权（$50 执行价，6/17/27 到期），以及一家没有股票代码的私人房地产 LLC。她 2026 年的其他 PTR：20033725（01/23）、20034836（06/23，Intel 和 Uber 看涨期权）以及 20035553（10/02，一家房地产 LLC）。然后说明：“这是一份在交易 28 天后提交的公开披露文件。它说明 Paul Pelosi 在 7 月买了什么，并不代表任何人接下来会买什么。”

如果用户想据此采取行动，就要经过完整流程：仅限股票（配置中 allow_options: false），由 /trader-budget 确定额度，由 /trader-risk 进行检查，并且只有在用户确认后，才由 /trader-broker 下单。

参议院：手动操作流程

参议院报告发布在 https://efdsearch.senate.gov。搜索前，网站会要求你勾选复选框，同意报告的使用受法律限制。这项协议需要由本人接受，因此此技能不会点击复选框或将其自动化。操作流程：

1. 用户在浏览器中打开 https://efdsearch.senate.gov/search/ 并自行接受协议。
2. 选择报告类型“Periodic Transactions”，输入参议员的姓氏，设置日期范围并搜索。
3. 打开报告：电子申报会显示交易表格，纸质申报则是扫描图像。
4. 将表格（或截图，或保存的页面）粘贴到聊天中，然后按与众议院条目相同的格式整理，并附上报告链接和同样的 45 天说明。

它绝不会做的事

• 绝不声称或暗示议员掌握内幕信息，也不声称跟随政客交易就能跑赢市场。绝不声称有任何收益。
• 绝不把一个范围说成精确的美元金额，也绝不把跟踪器日期说成交易日期。
• 绝不下单，也绝不复制期权交易。
• 绝不将参议院协议或任何登录操作自动化。

安全

• 用于教育和工具支持，不构成财务建议。本套件中的任何内容都不是买入或卖出任何资产的建议。
• 默认使用模拟交易（trader/config.json 中的 "paper": true）。
• 除 /trader-broker 外，没有任何操作会下单；且只有在 /trader-risk 检查通过、用户在聊天中明确输入“是”以确认该订单，并且 Claude 中的经纪工具设置为“需要批准”（Customize > Connectors > tool permissions），使 Claude 自身的“允许一次 / 拒绝”卡片也会出现后，才会下单。绝不要对下单工具选择“始终允许”。
• 除非配置允许且用户确认，否则不进行期权、保证金、卖空或杠杆交易。
• 国会交易属于公开披露信息，最迟可在交易后 45 天申报（《STOCK Act》）。此技能会快速读取这些信息；它没有内幕信息，并且会明确说明这一点。