etf-pcf-download
starsforks
How to install etf-pcf-download?
ftshare-lab/ftshare-skills/etf-pcf-download
$npx -y skills add FTShare-Lab/FTShare-skills --skill etf-pcf-download下载指定 PCF 文件（market.ft.tech）。用户问下载 PCF、PCF 文件内容、某只 ETF 申购赎回清单 XML 时使用。
SKILL.md
| 1 | # 下载指定 PCF 文件 - 下载指定 PCF 文件 |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 下载指定 PCF 文件 | |
| 8 | | 外部接口 | `GET /api/v1/market/data/etf-pcf/etf-pcfs/{filename}` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 根据 PCF 文件名下载对应 XML 文件内容，用于 ETF 申购赎回清单的详细数据 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | 说明：`filename` 为路径参数（必填），通常由 PCF 列表接口 `etf-pcfs` 的 `items[].filename` 获得。 |
| 15 | |
| 16 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 17 | |--------|------|----------|------|----------|------| |
| 18 | | filename | string | 是 | PCF 文件名（路径参数） | pcf_159003_20260309.xml | 由 PCF 列表接口的 items[].filename 获得 | |
| 19 | |
| 20 | ## 3. 响应说明 |
| 21 | |
| 22 | - **成功**：返回文件二进制流，`Content-Type: application/octet-stream`，`Content-Disposition: attachment; filename="{filename}"`。响应体为 PCF 的 XML 内容。 |
| 23 | - **失败**：HTTP 非 2xx，响应体为错误信息。 |
| 24 | |
| 25 | ## 4. 用法 |
| 26 | |
| 27 | 通过主目录 `run.py` 调用（必填 `--filename`，可选 `--output` 保存到文件）： |
| 28 | |
| 29 | ```bash |
| 30 | # 输出到 stdout，可重定向到文件 |
| 31 | python <RUN_PY> etf-pcf-download --filename pcf_159003_20260309.xml > pcf_159003_20260309.xml |
| 32 | |
| 33 | # 保存到指定文件（仅允许当前工作目录下路径，防止路径穿越） |
| 34 | python <RUN_PY> etf-pcf-download --filename pcf_159003_20260309.xml --output pcf_159003_20260309.xml |
| 35 | ``` |
| 36 | |
| 37 | `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。未传 `--output` 时 XML 输出到 stdout；传 `--output` 时写入该文件。本接口无需额外请求头。 |
| 38 | |
| 39 | ## 5. 请求示例 |
| 40 | |
| 41 | ``` |
| 42 | GET /api/v1/market/data/etf-pcf/etf-pcfs/pcf_159003_20260309.xml |
| 43 | ``` |
| 44 | |
| 45 | ## 6. 注意事项 |
| 46 | |
| 47 | - `filename` 须与列表接口返回的 `filename` 一致，且不得包含路径分隔符（如 `/`、`\`） |
| 48 | - 使用 `--output` 时仅可写入当前工作目录及其子目录，不可使用绝对路径或 `..` 穿越目录 |
| 49 | - **自动化/端到端测试**：不要硬编码 `filename`。应**先**调用 `etf-pcfs --date YYYYMMDD`，从响应 `items[].filename` 取真实文件名（上交所/深交所前缀不同），**再**调用本 skill；否则易 404 或文件不存在。 |
People who liked this also viewed
6 picksType
- azure-costAzure cost management: query costs, forecast spending, optimize to reduce waste. WHEN: \"Azure costs\", \"Azure bill\", \"cost breakdown\", \"how much am I spending\", \"forecast spending\", \"optimizSkillsJul 2026
- pricingWhen the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increaseSkillsJul 2026
- stripe-integrationMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- startup-financial-modelingMulti-harness agentic plugin marketplace for Claude Code, Codex CLI, Cursor, OpenCode, GitHub Copilot, and Gemini CLISkillsJul 2026
- tushare-finance专为 Claude Code 设计的 Tushare Pro 金融数据技能包，支持 220+ 个接口，用自然语言获取 A 股行情、财务数据、宏观经济等金融数据。SkillsJul 2026
- azure-pricingFetches real-time Azure retail pricing using the Azure Retail Prices API (prices.azure.com) and estimates Copilot Studio agent credit consumption. Use when the user asks about the cost of any Azure seSkillsJul 2026
