toor
2ce68b7b5d
- 新增 fin_mda/fin_equity/fin_company/fin_belong_index/fin_major_events 5 个模块 - 覆盖: 管理层讨论、股本结构、公司介绍、所属行业、指数分类/统计/成分、并购/股权激励/诉讼/关联交易/违规/担保 - _emchoice.fetch_report 支持"数据为空"按空结果处理 - api.py 增加 _simple_endpoint 统一生成纯 stocks 参数接口, 路由达 29 个 /fin 端点 - 冒烟测试扩展至 56 用例, 全部通过 - api_manual/blueprint/SKILLS/待优化 文档与代码路径 100% 对齐
38 lines
2.6 KiB
Markdown
38 lines
2.6 KiB
Markdown
|
||
---
|
||
|
||
## 你需要补的 EMWebApi 端点清单
|
||
|
||
按价值排序，按工作量排序（带推测的 CHOICE 接口 ID）：
|
||
|
||
### 🔴 高价值（建议优先补）
|
||
|
||
| # | 端点名 | 对应路径 | 用途 | 推测 CHOICE 接口 |
|
||
|---|--------|---------|------|-----------------|
|
||
| 1 | `/fin/holder` | 股东户数 + 十大股东 | 筹码集中度 + 机构动向 | `RPT_F10_EH_EHD` / `RPT_F10_SHAREHOLDER` |
|
||
| 2 | `/fin/valuation-history` | 历史 PE/PB 分位 | 当前估值贵不贵 | `RPT_VALUATION_ANALYSIS` |
|
||
| 3 | `/fin/profit-forecast` | 卖方一致预期 | 未来 EPS 预测 + 评级 | `RPT_PROFIT_FORECAST` 或 `RPT_F10_PROFITNOTE` |
|
||
| 4 | `/fin/industry-compare` | 行业横向对比 | 在行业里的位置 | `RPT_INDUSTRY_COMP` |
|
||
|
||
### 🟡 中价值（看时间补）
|
||
|
||
| # | 端点名 | 对应路径 | 用途 | 推测 CHOICE 接口 |
|
||
|---|--------|---------|------|-----------------|
|
||
| 5 | `/fin/cashflow-quarterly` | 单季度现金流量表 | 季度经营性现金流 | 在现有 `fin/cashflow` 上加 `reportType` 参数 |
|
||
| 6 | `/fin/operating-data` | 经营数据（药房专属） | 门店数、同店增长、新开/关闭 | `RPT_F10_OPDATA`（按行业走分表） |
|
||
| 7 | ~~`/fin/notice`~~ 重大事项 | ~~重组/激励/回购/担保~~ | ✅ 已实现 | 已拆为 6 个端点：`/fin/acquisitions`（并购）、`/fin/equity-incentive`（股权激励）、`/fin/litigation`（诉讼）、`/fin/related-transaction`（关联交易）、`/fin/violation`（违规）、`/fin/guarantee`（担保），模块 `utils/fin_major_events.py` |
|
||
|
||
### 🟢 低价值（看心情）
|
||
|
||
| # | 端点名 | 对应路径 | 用途 | 推测 CHOICE 接口 |
|
||
|---|--------|---------|------|-----------------|
|
||
| 8 | `/fin/management` | 管理层介绍 + 持股 | 老板背景、薪酬 | `RPT_F10_MANAGEMENT` |
|
||
| 9 | `/fin/top-flow` | 大宗交易 + 高管增减持 | 减持信号 | `RPT_F10_BIGTRADE` / `RPT_F10_HOLDERCHANGE` |
|
||
|
||
### 💡 实现提示
|
||
|
||
1. **`fin/operating-data` 是药房/银行/地产的行业专属接口**，CHOICE 不会给一个通用端点，可能要按行业分多个子接口（`fin/op-data-pharmacy` / `fin/op-data-bank` ...）
|
||
2. **`fin/holder` 通常分两张**：股东户数 + 十大股东明细，建议拆成两个端点更清晰
|
||
3. **接口 ID 不确定的话**：你先写一个能跑通的 demo（比如 `summary`），我这边按你的命名风格对照补其它4. **每个新接口都建议加 `org_code` 参数**（`stocks=603233.SH:10500736`格式），少走自动查询这一步，更稳
|
||
|
||
**优先级建议**：今晚先攻 1+2+3（持仓 + 估值历史 + 盈利预测），这三个对大参林的报告补全是**质变级别**的提升。其它周末慢慢来。 |