用途:pp-fec 是 Printing Press 为 FEC(美国联邦选举委员会)开放 API 提供的只读命令行封装,用于检索候选人、委员会及其竞选资金往来等公开数据。数据按 file ID 与 image ID 关联原始表格,每晚更新。
主要能力:提供候选人(candidate、candidates)、委员会(committee、committees)、申报文件(filings)、电子申报(efile)、日程(calendar-dates、election-dates、reporting-dates)、选举(elections)、法律文件(legal)、规则制定(rulemaking)、审计(audit-case、audit-category)、全国政党(national-party)、总统地图数据(presidential)、通信成本(communication-costs)、竞选宣传(electioneering)以及各类明细表(schedules,含 Schedule A/B/C/D/F)等命令,支持全文与字段检索、聚合统计和导出。
使用方式:先安装 CLI,可用 npx -y @mvanhorn/printing-press-library install fec --cli-only,默认安装到 $HOME/.local/bin(macOS/Linux)或 %LOCALAPPDATA%\Programs\PrintingPress\bin(Windows);也可用 go install github.com/mvanhorn/printing-press-library/library/other/fec/cmd/fec-pp-cli@latest(需 Go 1.26.6 或更新)。安装后用 fec-pp-cli --version 验证,并确保安装目录在 $PATH 中。调用 API 可申请密钥,未申请时可用 DEMO_KEY;有密钥时每小时最多 1,000 次调用,每页最多 100 条结果,可申请提升至每小时 7,200 次。
适用场景:竞选资金研究、候选人/委员会检索、申报与明细数据导出、选举日程查询等。
限制:本 CLI 仅提供只读命令,不应用于创建、更新、删除、发布、评论、投票、邀请、下单、发送消息、预订、购买或改变远端状态的操作。FEC 数据使用受限,例如贡献者名单不得用于商业目的或募捐。filings 等大数据集计数为近似值,需分页直至无返回。部分命令细节与参数暂未提供。