用途:针对选定公司及交易日期窗口,描述已申报的内部人买卖活动,支持按交易代码、所有人角色、日期窗口、证券类别等维度整理,区分数量与对价口径。
主要能力:可通过实时 SEC 与已存储的 Form 3/4/5 记录采集证据,解析公司身份与 CIK、申报所有人姓名与机构管理人 CIK 等不同身份;保留 accession/表单、所有人姓名与职务、返回的角色标记、证券名称、交易代码、取得/处置指示、股数、每股价格、交易后持有及来源 URL;对重复观测按 accession 与行标识去重,保留原始与修正申报并标注可能的替换。
使用方式:需设置 CRAWLORA_API_KEY;已连接时优先用 Crawlora MCP 工具,否则用随附 scripts/crawlora.sh,向 https://api.crawlora.net/api/v1 发送 x-api-key。方法参数见 reference/endpoints.md。示例命令:scripts/crawlora.sh /sec/company/search q=Apple;随后用已验证的发行人 CIK,例如 scripts/crawlora.sh /sec/insider cik="$COMPANY_CIK" limit=30;存储历史示例:scripts/crawlora.sh "/datasets/sec-companies/insider/$COMPANY_CIK" from=2026-01-01 to=2026-10-05 limit=200。
限制:实时内部人数据为有界近期窗口(limit 最大 30);存储历史按交易日期过滤且最多返回 200 行、由新到旧,并非分页式完整档案。未知 CIK 或缺失历史可能返回空序列,不代表未发生交易。认证错误应停止,429 应退避,上游瞬时失败重试一次,并按请求范围与额度上限控制调用/翻页。计算股数×每股价格仅限兼容数值单位与有意义价格,标为估计申报对价,不等同利润或净现金流;缺失价格保持未知,零价格可能表示授予或转让。董事/高管/百分之十所有人标记可重叠,组总计不一定可加;不得合并不同股份类别或衍生品。持有后数据有独立范围,不保证当前所有权。不得据申报活动推断意图、违法行为、计划状态、完整持仓或未来价格表现,也不授权交易或账户操作。部分端点细节、收费与配额等暂未提供。