sn-search-market-cn

1# 中国市场商业搜索
2 
3## 凭证配置
4 
5API key、token 与 cookie 统一建议写在仓库根目录 `.env`（参考 `.env.example`），并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证；不要把真实密钥写入 skill payload、报告、日志或提交。
6 
7只使用本技能列出的中国官方免费资源。不要补充表外资源；遇到注册、登录、验证码、授权码、API key、OAuth、数字签名对接、商业试用、付费墙、访问防护或加密货币数据，立即放弃该资源。
8 
9## 工作流
10 
111. 明确研究对象：行业、公司、地区、时间段、指标口径和需要的证据类型。
122. A 股公告、年报、季报、问询函先用 API 脚本；脚本拿不到再用 browser-use 打开巨潮页面。
133. 其它资源统一用 browser-use 正常访问网页，通过站内搜索、栏目导航、筛选器和公开下载文件取数。
144. 宏观、监管、招投标、采购、行业运行数据优先引用官方页面或官方文件链接；结论中保留来源 URL、指标口径和时间范围。
155. 不绕过验证码、防护页、登录墙、签名接口或授权申请；不要采集个人敏感信息。
16 
17## API 脚本
18 
19脚本：`scripts/free_market_api.py`。只依赖 Python 标准库。
20 
21可用接口：
22 
23| 命令 | 来源 | 适合用途 |
24| --- | --- | --- |
25| `cninfo-announcements` | 巨潮资讯公告查询接口 | A 股公告、年报、季报、问询函、招股书线索 |
26 
27示例：
28 
29```bash
30python scripts/free_market_api.py cninfo-announcements --keyword 年报 --start-date 2026-01-01 --end-date 2026-05-18 --page-size 5
31python scripts/free_market_api.py cninfo-announcements --keyword 业绩说明会 --page-size 10
32python scripts/free_market_api.py cninfo-announcements --keyword 问询函 --start-date 2026-04-01 --end-date 2026-05-18
33```
34 
35输出 JSON 中的 `data.announcements[].pdfUrl` 是公告 PDF 地址，可直接作为引用或交给 browser-use 打开核对原文。
36 
37## Browser-use 资源
38 
39以下资源没有可直接使用的免 key API，或接口需要签名/授权；统一用 browser-use 访问网页。
40 
41| 场景 | 资源 | URL | 用法 |
42| --- | --- | --- | --- |
43| 宏观经济 | 国家统计局国家数据 | https://data.stats.gov.cn/ | GDP、CPI、PPI、PMI、工业、社零、固定资产投资、房地产、人口、就业 |
44| 宏观经济 | 国家统计局官网 | https://www.stats.gov.cn/ | 统计公报、月度/年度统计、专题数据、新闻发布稿 |
45…