SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场trader-pelosi

trader-pelosi

数据与分析

查看项目

更新于 10-21 13:01

技能介绍

trader-pelosi 是一个用于追踪美国国会议员股票交易披露的技能工具。根据 STOCK Act，国会议员及其配偶、受抚养子女的交易必须报告，众议院书记官办公室将每份报告以 PDF 形式发布，并按年度汇总在一个索引文件中。该技能读取该索引，发现新报告出现时自动下载并解析。

用途

该技能用于快速读取公开的国会交易披露文件，帮助用户了解议员及其家属的股票交易情况。它强调速度而非提前性：PTR 报告在议员知悉交易后 30 天内提交，且不超过交易后 45 天，因此当报告可读时，交易已过去数天或数周。技能明确说明不包含内幕信息，只有公开文件。

主要能力

  • 读取众议院披露索引：从 https://disclosures-clerk.house.gov/public_disc/financial-pdfs/<YEAR>FD.zip 获取年度索引，包含议员姓名、选区、文件类型、提交日期和 DocID。
  • 下载并解析 PTR PDF：从 .../public_disc/ptr-pdfs/<YEAR>/<DocID>.pdf 下载报告，使用 pdftotext（可选）提取文本并解析为结构化行。
  • 状态管理：将已显示的 DocID 记录在 trader/state/pelosi.json，确保每份 PTR 只提醒一次；下载的 PDF 保存在 trader/state/ptr-pdfs/。
  • 持仓标记：读取 trader/portfolio.json（如存在），标记用户持有的股票相关交易。
  • 索引查询：支持按议员姓名（姓氏、全名或“姓, 名”）、日期范围、年份筛选，可列出所有文件类型。
  • 新报告监控：仅显示上次检查后未见的 PTR，首次运行显示最近 45 天；支持 --read 下载并读取，退出码 1 表示无新内容。
  • 报告读取：fetch 命令保存 PDF 并打印行；parse 命令将 pdftotext -layout 文本转为行，需核对行数与 PDF 页数。

使用方式

工具位于技能目录，使用 Python 标准库，pdftotext 为可选依赖。命令示例：

python3 "${CLAUDE_SKILL_DIR}/ptr.py" --help python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member pelosi python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --since 2026-10-01 python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member "Josh Gottheimer" --year 2025 python3 "${CLAUDE_SKILL_DIR}/ptr.py" new --member pelosi --read python3 "${CLAUDE_SKILL_DIR}/ptr.py" fetch 20035143 python3 "${CLAUDE_SKILL_DIR}/ptr.py" parse ptr.txt --filed 2026-08-21 --json

--member 接受姓氏、“First Last”或“Last, First”，可重复。--type '' 列出所有文件类型（年度报告为 O 型）。new 命令在 1 月还会检查上一年的索引。书记官办公室约每天重建一次索引文件，因此工作日每小时检查一次足够，可用 /loop 1h 或计划任务运行。

规则与注意事项

  • 引用文件而非追踪器：每行数据来自书记官办公室的 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 天标记为迟交。
  • 期权是期权：带有行权价和到期日的看涨期权不是股票购买。工具从描述中读取合约、行权价和到期日，并标记行权。

示例提醒

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. 将表格（或截图、保存的页面）粘贴到聊天中，然后以与 House 行相同的格式撰写，附上报告链接和相同的 45 天提醒。

绝不做什么

  • 绝不说或暗示议员拥有内幕信息，或复制政客能跑赢市场。不声称回报。
  • 绝不将区间呈现为精确金额，或将追踪器日期作为交易日期。
  • 绝不下单，绝不复制期权交易。
  • 绝不自动化参议院协议或任何登录。

安全

教育和工具，非财务建议。本包中没有任何内容构成买卖任何东西的建议。默认模拟交易（trader/config.json 中 "paper": true）。除 /trader-broker 外，没有任何东西会下单，且仅在 /trader-risk 通过、用户在聊天中为该订单明确输入 yes、且经纪工具在 Claude 中设置为“Needs approval”（Customize > Connectors > tool permissions）以显示 Claude 自己的“Allow once / Deny”卡片后。绝不对订单工具选择“Always allow”。除非配置允许且用户确认，否则不使用期权、保证金、卖空或杠杆。国会交易是交易后最多 45 天提交的公开披露（STOCK Act）。该技能快速读取它们；它没有内幕信息，并且会说明这一点。