用途:检索美国众议院和参议院公开财务披露申报,建立申报清单或证据摘要。需先设置 CRAWLORA_API_KEY;已连接 Crawlora MCP 工具时优先使用,否则使用 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。具体方法与参数见 reference/endpoints.md。检查应用代码与 HTTP 状态,数据在 data 内;认证错误应停止,429 退避,瞬时上游错误重试一次;调用与分页受范围与额度约束,并保留来源 ID、URL、检索时间与来源日期。
主要能力与检索规则:众议院检索需 member,默认申报人类型为 member,候选人使用 filer_type=candidate 与 election_year;from/to 按年,候选人行为 year_kind=election,列表结果不提供 filed_at,不可由年份臆造。参议院支持姓名前缀或 member 简写但不能同时使用;state 不能与 senator_state/candidate_state 组合;申报人与报告类型须严格按参考文档,all 不能与其他申报人值组合;from/to 可为年份或 MM/DD/YYYY 申报日期。ticker 为非支持兼容参数,非空会返回校验错误;资产问题应取有界相关样本后在本地筛选交易行,不能承诺全议会范围内的完整 ticker 检索。示例:scripts/crawlora.sh /congress/stock-disclosures chamber=senate report_type=periodic_transaction from=2026 to=2026 page=1 limit=10;对受支持的参议院 filing_url 使用 scripts/crawlora.sh /congress/report url="$FILING_URL"。
文档解析与限制:congress_report 支持参议院年度报告、PTR 与常规延期通知的 HTML URL。众议院 PDF、参议院纸质/图像申报、盲信托等报告不受该解析器支持,应保留来源链接并标注正文/交易不可用。申报行仅证明已编制索引,不代表交易细节已获取;延期通知正文是通知而非资产或交易表,其结构化字段可能为空。对受支持报告使用规范化交易并保留 parts[].rows、source_part 与行号以便核验;记录交易日期、所有人(self/spouse/dependent)、类型、资产名、ticker、金额区间、备注与 -- 占位符,区分交易、报告期、申报与检索日期;申报窗口筛选不等于交易窗口。
对账与报告:按议会与可用身份证据匹配申报人,不单凭姓名。同一交易可能同时出现在年度报告与 PTR:比较所有人、资产、日期、类型与区间,保留双方来源行,标注可能重复但不合并不确定匹配。修正版与原始版需可追溯,无文档证据不得推断替代。不得将金额区间转为精确值或汇总开放式区间为精确交易总额;卖出不等于实现利润,资产条目不等于交易,配偶申报交易不自动等于申报人本人决定。输出申报覆盖、已解析/不可用文档、交易证据台账、未解决重复与明确的日期/区间限制。该样本不能证明当前组合、交易意图、违法或投资回报,也不得据此推导申报截止日期或交易建议。适用场景:公开披露研究、清单编制与证据整理。限制:仅限资料所述范围,缺失事实暂未提供。