FTShare-announcements-data

FTshare 公告与研报数据 Skills

本 skill 是 FTShare-announcements-data 的统一路由入口。

根据用户问题，从下方「能力总览」匹配对应子 skill，然后通过 run.py 执行并解析响应。

所有接口均以 https://market.ft.tech 为基础域名，使用 HTTP GET。

调用方式（唯一规则）

run.py 与本文件（SKILL.md）位于同一目录。执行时：

1. 取本文件的绝对路径，将末尾 /SKILL.md 替换为 /run.py，得到 <RUN_PY> 。
2. 调用：python <RUN_PY> <子skill名> [参数...]

# 示例（<RUN_PY> 为实际绝对路径）
python <RUN_PY> stock-announcements-all-stocks-specific-date --start-date 20241231 --page 1 --page-size 20
python <RUN_PY> stock-announcements-single-stock-all-periods --stock-code 000001.SZ --page 1 --page-size 20
python <RUN_PY> stock-announcements-specific-url-hash --url-hash <hash> --output announcement.pdf
python <RUN_PY> stock-reports-all-stocks-specific-date --start-date 20241231 --page 1 --page-size 20
python <RUN_PY> stock-reports-single-stock-all-periods --stock-code 000001.SZ --page 1 --page-size 20
python <RUN_PY> stock-reports-specific-url-hash --url-hash <hash> --output report.pdf

run.py 内部通过 __file__ 自定位，无论安装在何处都能正确找到各子 skill 的脚本。

能力总览

1. 公告

• stock-announcements-all-stocks-specific-date：指定日期全市场股票公告列表（分页）。必填参数：--start-date（YYYYMMDD）；可选 --page、--page-size。

• stock-announcements-single-stock-all-periods：单只股票公告历史（分页）。必填参数：--stock-code（带市场后缀，如 000001.SZ）；可选 --page、--page-size。

• stock-announcements-specific-url-hash：通过 url_hash 查询/下载单条公告 PDF。必填参数：--url-hash；可选 --output（保存文件名）。

2. 研报

• stock-reports-all-stocks-specific-date：指定日期全市场股票研报列表（分页）。必填参数：--start-date（YYYYMMDD）；可选 --page、--page-size。

• stock-reports-single-stock-all-periods：单只股票研报历史（分页）。必填参数：--stock-code（带市场后缀）；可选 --page、--page-size。

• stock-reports-specific-url-hash：通过 url_hash 查询/下载单条研报 PDF。必填参数：--url-hash；可选 --output（保存文件名）。

使用流程

1. 记录本文件绝对路径，将 /SKILL.md 替换为 /run.py 得到 <RUN_PY>。
2. 理解用户意图，从「能力总览」匹配对应子 skill 名称。
3. （可选）读取 <RUN_PY> 同级目录 sub-skills/<子skill名>/SKILL.md 了解接口详情与参数。
4. 执行：python <RUN_PY> <子skill名> [参数...]，获取 JSON 输出。
5. 解析并输出：以表格或要点形式展示给用户。

子 skill 与用户问法示例