trader-pelosi

trader-pelosi

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

它很快，但并不提前。议员在得知交易后 30 天内必须提交 PTR，且最迟不得超过交易发生后 45 天。因此，等到任何人能读到报告时，交易已经过去几天或几周了。这里没有内幕信息：只有公开申报，只是读取得很快。每次都要说明这一点。

此文件夹中的工具（使用 Python 标准库；可选使用 poppler 的 pdftotext 在本地读取 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 核对行数。

示例：真实提醒

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 月买了什么，而不是任何人接下来会买什么。”

如果用户想据此采取行动，就应该走更长的流程：披露信息已经过时数周，因此它是查看图表的理由，而不是交易信号。由 /trader-scanner 和 /trader-entry 判断今天是否有交易；然后只买股票（配置中 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》）。此技能会快速读取这些信息；它没有内幕信息，并且会明确说明这一点。