Skillppx logo

Edgar Crawler

批量抓取美股上市公司年报与季报，支持增量更新与本地缓存。

已扫描
适合谁
量化研究员、美股投资者
不适合谁
非美股市场用户、无编程基础的普通用户
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
中等（★★☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @tangweigang-jpg/edgar-crawler
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

EDGAR 文件抓取 (edgar-crawler)

从 SEC EDGAR 批量抓取上市公司年报（10-K）和季报（10-Q）文件，支持按季度增量更新与本地缓存，适用于美股基本面分析和量化研究数据获取。

Pipeline

data_collection -> data_storage -> factor_computation -> target_selection -> trading_execution -> visualization

主要用途（共 1 项）

SEC EDGAR 文件提取 (UC-101)

从压缩的 ZIP 压缩包中提取并处理 SEC EDGAR 报告文件（包括 10-K 年度报告和 10-Q 季度报告），用于后续财务分析

触发条件：EDGAR、SEC 报告、10-K 提取

执行触发条件：当用户意图匹配 intent_router.uc_entries[].positive_terms 中的关键词，并且使用了动作动词（如 run/execute/跑/执行/backtest/fetch/collect）时

我会向你询问的问题

  • 目标市场：A 股（默认）、港股或加密货币？（US 股票在 ZVT 中支持不完整——stockus_nasdaq_AAPL 存在但覆盖较弱）
  • 数据源 / 提供方：eastmoney（免费，无需账号）、joinquant（需账号+付费）、baostock（免费，历史数据良好）、akshare 或 qmt（券商接口）？
  • 策略类型：MACD 金叉、均线交叉、成交量突破、基本面筛选，或自定义因子？
  • 时间范围：回测起止时间戳（start_timestamp 和 end_timestamp）
  • 目标实体 ID：特定股票（stock_sh_600000）或指数成分股（SZ1000）？

语义锁定规则（致命错误）

ID规则违反后果
SL-01每个交易周期内必须先执行卖出订单，再执行买入订单停止执行
SL-02交易信号必须采用次日开盘价执行（禁止前瞻）停止执行
SL-03实体 ID 必须符合格式：entity_type_exchange_code停止执行
SL-04DataFrame 索引必须为 MultiIndex（entity_id, timestamp）停止执行
SL-05TradingSignal 必须且仅能包含以下一项：position_pct、order_money、order_amount停止执行
SL-06filter_result 列语义：True=买入，False=卖出，None/NaN=无操作停止执行
SL-07因子管道中 Transformer 必须在 Accumulator 之前运行停止执行
SL-08MACD 参数固定：fast=12, slow=26, signal=9停止执行

完整锁定规则说明：[references/LOCKS.md](references/LOCKS.md)

主要反模式（共 14 项）

  • **AP-DATA-SOURCING-001**：SEC API 请求缺少或无效的 User-Agent 头部
  • **AP-DATA-SOURCING-002**：忽略外部 API 速率限制导致 IP 被封禁
  • **AP-DATA-SOURCING-003**：未配置 HTTP 超时时间，导致请求无限挂起

全部 14 项反模式：[references/ANTI_PATTERNS.md](references/ANTI_PATTERNS.md)

证据质量提示

[质量提示] 本晶片由 blueprint finance-bp-114 编译生成。证据验证率 = 32.9%，审计失败总数 = 29。生成结果可能存在未捕获的需求缺口。关键决策请对照源文件（LATEST.yaml / LATEST.jsonl）进行核实。

参考文件

文件内容加载时机
[references/seed.yaml](references/seed.yaml)V6+ 全量权威（源数据）出现行为或决策争议时必读
[references/ANTI_PATTERNS.md](references/ANTI_PATTERNS.md)14 条跨项目反模式开始实现前
[references/WISDOM.md](references/WISDOM.md)跨项目精华经验借鉴架构决策时
[references/CONSTRAINTS.md](references/CONSTRAINTS.md)domain + 致命约束规则冲突时
[references/USE_CASES.md](references/USE_CASES.md)全量 KUC-* 业务场景需要完整示例时
[references/LOCKS.md](references/LOCKS.md)SL-* + 前置条件 + 提示信息生成回测/交易代码前
[references/COMPONENTS.md](references/COMPONENTS.md)AST 组件地图（按 module 拆分）查看 API 时

*由 Doramagic 晶片编译器 v6.1 从 finance-bp-114 蓝图于 2026-04-22T13:00:54.950360+00:00 生成。*

*详见 [human_summary.md](human_summary.md) 获取非技术性概述。*

TJ
@tangweigang-jpg

已收录 2 个 Skill

相关推荐