trader-copycat 是一个用于“复制投资者”持仓的技能,其数据基础是投资管理人依法必须向 SEC 提交的 13F-HR 文件:任何管理超过 1 亿美元美国上市股票及其他 13(f) 证券的投资经理,每季度都需提交该文件。该技能从 SEC EDGAR 直接读取文件,重建组合,并将其转换为适合自己账户的目标权重。
工具:本文件夹内的标准库 Python 脚本,无需密钥:
python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" --help
SEC 要求每个程序以名称和邮箱表明身份。需在 trader/config.json 中设置一次("sec_user_agent": "Your Name you@example.com",使用用户真实姓名和邮箱),或导出 SEC_USER_AGENT=...。缺少该信息时工具会拒绝调用 SEC 并提示修复方式;需向用户索取,不得编造。
使用方式(四步):
第 1 步:查找投资者。
python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" find buffett python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" find "pershing square" --sec
filers.json 列出 23 位知名申报人,其 CIK 已于 2026-10-13 对照 SEC 核验(包括 Berkshire、Pershing Square、Scion、Bridgewater、ARK、Duquesne、Appaloosa、Baupost 等)。--sec 按名称搜索 EDGAR 所有申报人。若某申报人已停止申报(Scion 最近一份 13F-HR 为 2025-11-03),需说明。
第 2 步:读取最新季度。
python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" filings 1067983 python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" holdings 1067983 --combine --top 15
工具会下载提交列表,选取最新的原始 13F-HR,在申报文件夹中找到信息表 XML,汇总每个持仓被拆分的多行(Berkshire 会将一只股票分散在多个子公司下申报),核对总额与封面页,并匹配股票代码:优先使用 trader/tickers.json,其次 share_classes.json(已核验的多类别公司 CUSIP),再按名称使用 SEC 的 company_tickers.json,或用 --figi 调用 OpenFIGI 的免费 CUSIP 查询。--combine 将同一公司的多个股票类别合并(如 Alphabet A + C)。若该季度存在修订文件,工具会提示,可用 --accession 读取。
第 3 步:查看变化。
python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" diff 1067983
列出新增持仓、清仓、增持和减持,按股数与上一季度对比。这是两个日期的持股数,而非交易:应说“6 月 30 日持股多于 3 月 31 日”,绝不能说某日“买入”。
第 4 步:写入目标。
python3 "${CLAUDE_SKILL_DIR}/edgar13f.py" copy 1067983 --top 5 --out trader/targets.json
默认合并股票类别(--separate 保持分开);--exclude TICKER 排除用户不愿持有的标的;--min-pct 1 过滤极小仓位。权重为每个持仓占 13F 的百分比,并按所选持仓缩放至合计 100。展示表格后交由 /trader-budget 处理。
输出文件: trader/targets.json:要复制的权重,格式为 { "source", "as_of", "weights": [ {"ticker", "name", "weight"} ] },权重为百分比、保留两位小数,在股票部分合计 100(保留两位小数是因为预算分配需要),另含 13F 的股数、市值、CUSIP、跳过项及原因和注意事项。 trader/tickers.json(可选,用户提供):CUSIP 到股票代码的修正,工具会优先使用,格式如 {"650111107": "NYT"}。 本文件夹中的 targets.example.json 为实际运行输出(Berkshire 前 5)。
规则: 每次都要说明数据时效。13F 是季度最后一天的快照,最迟在 45 天后提交。凡使用 13F 的回答都需说明“持仓截至 2026-06-30,提交于 2026-08-14”。 说明其无法展示的内容:仅限美国上市多头,不含做空、现金、债券、外国股票、私募公司、季度内买卖及支付价格。 是公司而非个人在申报。Berkshire Hathaway 提交 13F,而非 Warren Buffett 本人。Greg Abel 自 2026-01-01 起任 CEO,Buffett 于 2026-09-18 成为荣休董事长。绝不能把文件中的“Berkshire 持有”说成“Buffett 买入”。 每个数字都来自文件。引用 accession number 并链接信息表。若股票代码是猜测(标 *),需说明并用 --figi 或 trader/tickers.json 修正后再复制。 期权和债券永不复制。PUT、CALL 和 PRN 行列为排除项。除非配置允许,本包只交易股票。
Form 4(可选):内部人和 10% 以上股东须在两个工作日内通过 Form 4 报告交易。查看方式:打开 https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=<CIK>&type=4&owner=include (或申报人的提交列表),阅读用户指定的文件。它们比 13F 更快,但一次只覆盖一只股票。
示例:“复制 Berkshire Hathaway 前 5。”最新 13F-HR 对应截至 2026-06-30 的季度,提交于 2026-08-14,accession 0001193125-26-352200,总额 $299,253,556,246(与封面页一致)。Apple 22.04%(复制权重 30.67)、American Express 17.14%(23.85)、Alphabet(GOOGL + GOOG 合并)12.62%(17.56)、Coca-Cola 10.86%(15.11)、Bank of America 9.20%(12.80)。四舍五入为 30.7 / 23.9 / 17.6 / 15.1 / 12.8。相较上一季度:新增 D.R. Horton(3,564 股),清仓 Constellation Brands,增持 Alphabet、Delta、Lennar、Macy's 和 New York Times,减持 Bank of America、Kroger、Capital One、Nucor、Ally 和 DaVita。然后说明:“这些是 Berkshire 截至 2026 年 6 月 30 日的持仓。接下来由 /trader-budget 按你的 $5,000 分配规模。”
限制与安全: 绝不断言投资者今天仍持有或其买入原因;绝不断言收益或复制基金能赚钱(13F 复制是在基金买入数月后按当日价格买入);绝不代为下单,只写目标权重,规模分配、风险检查和用户确认在后;绝不超出 SEC 公平访问限制(每秒 10 次请求,工具远低于此)。 教育与工具性质,不构成财务建议;本包任何内容都不是买卖建议。默认模拟交易(trader/config.json 中 "paper": true)。只有 /trader-broker 可下单,且须 /trader-risk 通过、用户在该订单于聊天中明确输入 yes、且经纪工具在 Claude 中设为“需要批准”(Customize > Connectors > tool permissions)以显示“Allow once / Deny”卡片;绝不对下单工具选“Always allow”。除非配置允许且用户确认,否则不使用期权、保证金、做空或杠杆。13F 数据按季度、提交时最多已滞后 45 天,需说明。