opd-data

OPD 金融数据查询

通过 OPD 数据接口（https://api.originp.com）查询 A 股上市公司数据，共 62 个接口、6 大类。

环境准备（首次使用，一次性）

1. 获取 API Key：由 OPD 平台分配，形如 opd_xxx。注册/订阅等管理操作在 https://data.originp.com/ 完成（该站提供页面服务）；https://api.originp.com 为接口调用地址，专供程序调用、不含页面。注意：除 Key 外还需订阅所需接口（试用或购买套餐），未订阅的接口调用会返回 BIZ_INTERFACE_FORBIDDEN。
2. 配置 API Key（推荐，一句话完成）：用户把密钥发给小龙虾（如「配置我的数据密钥：opd_xxx」）后，执行：

   python scripts/opd_query.py --set-key opd_用户的Key
   

   Key 会保存到 ~/.opd/api_key，脚本自动读取，无需重启即可生效。若用户不愿在对话中发送密钥，可在终端自行运行 python scripts/opd_query.py --set-key，按提示粘贴 Key（从标准输入读取，不留在命令历史）。
3. （可选，兼容旧方式）配置环境变量 OPD_API_KEY：
   • Windows（用户级，需在配置后重启 OpenClaw Gateway 才会对 Agent 生效）：

     [Environment]::SetEnvironmentVariable("OPD_API_KEY", "opd_你的Key", "User")
     

   • Linux/macOS：在 shell 配置文件中加入 export OPD_API_KEY=opd_你的Key
4. 验证配置：

   python scripts/opd_query.py --check
   python scripts/opd_query.py co_info --fields sec_code --limit 1
   

   返回 JSON 中 code=0 即成功；--check 会显示掩码与 Key 来源（--api-key 参数 / 环境变量 / 配置文件）。

调用方法

使用本技能目录下的 scripts/opd_query.py（命令中的 scripts/opd_query.py 相对本技能目录，如 ~/.openclaw/workspace/skills/opd-data/；在其他目录执行时请使用完整路径）：

python scripts/opd_query.py <接口短名> --fields <字段1,字段2,...> [--过滤参数 值 ...] [--limit N] [--offset N]

示例：

# 查询平安银行的证券简称与董事长
python scripts/opd_query.py co_info --fields sec_code,sec_name,chairman --sec_code 000001

# 查询 2024 年全年日行情收盘价（日期 between：两个边界逗号分隔）
python scripts/opd_query.py daily_quote_hist --fields trade_date,close --sec_code 000001 --trade_date 2024-01-01,2024-12-31 --limit 300

调用规范

1. 鉴权：脚本自动读取 Key（优先级：--api-key 参数 > 环境变量 OPD_API_KEY > 配置文件 ~/.opd/api_key，见"环境准备"）。缺失或无效时脚本会报错——按下方"错误码与处置"指引用户修复，不要凭记忆编造数据。
2. fields 必填：各接口返回字段可选值见 references/ 分类文档的"返回字段"表（标注"默认返回"的字段未指定时也会返回）。不传返回 BIZ_PARAM_INVALID。
3. 统一响应：{code, message, data}；业务错误同为 HTTP 200，code != 0 即失败。脚本业务错误退出码为 2（网络/HTTP 错误为 1）。
4. 分页：limit 默认 20、最大 5000；offset 为位移量。取全量数据时循环翻页直至 data 为空。
5. 多值与区间：in 操作符参数（如 sec_code）逗号分隔多值；between 操作符参数（如日期）逗号分隔两个边界。
6. 限频：每分钟 60 次，批量查询时控制节奏。
7. 按需加载：先在下方速查表确定接口名与额外必填参数，再查阅对应 references/ 文档获取过滤参数与字段可选值；不要一次读取全部参考文档。
8. Key 安全：用户主动发送密钥时，可用 --set-key 将其保存到 ~/.opd/api_key（唯一允许的落盘位置，本地单用户受保护）；不得写入其他文件、不得回显到对话输出。若用户不愿发送密钥，指引其终端运行 python scripts/opd_query.py --set-key（标准输入粘贴，不落命令历史）或改用环境变量方式自行配置。

错误码与处置

接口速查表

基本信息（references/catalog_basic.md，6 个接口）

交易信息（references/catalog_trading.md，11 个接口）

财务信息（references/catalog_finance.md，16 个接口）

融资分配（references/catalog_financing.md，8 个接口）

重大事项（references/catalog_events.md，6 个接口）

股权与治理（references/catalog_governance.md，15 个接口）

图表输出

统一使用 echarts-ai-skill 生成图表（交互式 HTML）。不要探测或使用 matplotlib、mplfinance、pyecharts 等 Python 绘图库——本机不作为绘图路线，探测它们只会产生报错。也不要执行 pip install 安装绘图库。

用户需要可视化时，将查询结果交给 echarts-ai-skill 技能渲染（交互式 HTML，浏览器打开查看）：

1. 用本技能查询数据后，将 data 数组整理为 ChartRequest JSON（dataset 即行数组，字段名对应接口返回字段）。
2. 调用 echarts-ai-skill 的命令生成图表（工作目录为其技能目录）：

   node dist\cli\generate-chart.js --input  --out 
   node dist\cli\render-chart.js --input  --format html --out <输出路径.html>
   

3. 用 start <输出路径.html> 为用户打开浏览器查看。

常用图表映射：

复杂需求可用 rawOption 透传任意 ECharts 配置。