新增公司资料/指数/重大事项等 13 个接口, 文档全面对齐

- 新增 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% 对齐
2026-08-15 11:34:11 +08:00
parent 797369bbed
commit 2ce68b7b5d
13 changed files with 1147 additions and 11 deletions
@@ -335,3 +335,249 @@ Sec-Fetch-Dest: empty
 Referer: https://emchoicew.eastmoney.com/
 Accept-Encoding: gzip, deflate, br

+## 管理层讨论与分析
+---
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_BUSINESSANALYSIS&columns=ORG_CODE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_INNER_CODE%2CSECURITY_NAME_ABBR%2CREPORT_DATE%2CREPORT_NAME%2CNOTICE_DATE%2CSOURCE%2CRELINFOCODE%2CTITLE%2CPAGE&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(REPORT_NAME+in+(%22%E5%B9%B4%E6%8A%A5%22%2C%22%E4%B8%AD%E6%8A%A5%22))(REPORT_DATE%3C%3D%272026-08-15%27)(REPORT_DATE%3E%3D%272021-08-15%27)&pageNumber=1&pageSize=50&sortTypes=-1&sortColumns=REPORT_DATE&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+## 	股本结构
+---
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_F10_EH_EQUITY&columns=CHOICE_F9_EH_EQUITY&quoteColumns=&pageNumber=1&pageSize=&sortColumns=END_DATE&client=SW&filter=(SECUCODE=%22603233.SH%22)(LISTING_DATE%3E=%271900-01-01%27)(LISTING_DATE%3C=%272026-12-31%27)&sortTypes=-1 HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+version: 
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+token: 
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+## 按地区分类
+---
+GET /stock/f9/ZYGC_AFLZS?SecurityCode=603233.SH&StartDate=2023-08-15&EndDate=2026-08-15&ReportPeriodType=%221%22%2C%225%22%2C%223%22%2C%226%22&Magnitude=4&ClassifyType=%E5%9C%B0%E5%8C%BA&ReportShowForm=0&ExchangeRate=1&Digits=2&Sort=-1&IsShowEmptyRow=true HTTP/2
+host: emchoicews2.eastmoney.com
+sec-ch-ua: "Chromium";v="104"
+accept: application/json
+sec-ch-ua-mobile: ?0
+user-agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+origin: https://emchoicew.eastmoney.com
+accept-language: zh-CN,zh;q=0.9
+sec-fetch-site: same-site
+sec-fetch-mode: cors
+sec-fetch-dest: empty
+referer: https://emchoicew.eastmoney.com/
+accept-encoding: gzip, deflate, br
+
+## 公司介绍 + 所属行业与指数
+---
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_HSF9_BASIC_ORGINFO&columns=HSF9_ORGINFO&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)&pageNumber=1&pageSize=200&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---
+GET /api/data/v1/get?reportName=RPT_STOCKF9_INDUSTRY&columns=SECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CINDUSTRY_TYPE_CODE%2CINDUSTRY_TYPE%2CINDUSTRY_NAME%2CINDUSTRY_CODE%2CSECURITY_INNER_CODE%2CINDUSTRY_NAME_MIN%2CINDUSTRY_CODE_MIN%2CENTRY_DATE%2COUT_DATE%2CSECURITY_TYPE_CODE%2CSTATE%2CSTATE_CODE%2CRN&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(STATE_CODE%3D%221%22)&pageNumber=&pageSize=&sortTypes=1&sortColumns=RN&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---
+GET /api/data/v1/get?reportName=RPT_HSF9_BELONGINDEX_CLASSIF&columns=INDEX_CLASSIF_CODE%2CINDEX_CLASSIF&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(STR_TYPE%3D%221%22)&distinct=INDEX_CLASSIF_CODE%2CINDEX_CLASSIF&pageNumber=&pageSize=&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---
+GET /api/data/v1/get?reportName=RPT_CUSTOM_HSF9_BELONG_INDEX&filter=(SECUCODE%3D%22603233.SH%22)&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---
+GET /api/data/v1/get?reportName=RPT_HSF9_BELONG_INDEX&columns=INDEX_CODE%2CINDEX_INNER_CODE%2CTRADE_DATE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CINCLUDE_DATE%2CMAKER_NAME%2CINDEX_NAME_ABBR%2CSECURITY_INNER_CODE%2CINDEX_CLASSIF_CODE%2CINDEX_CLASSIF%2CWEIGHT%2CNUM%2CTOTAL_SCALE%2CWEIGHT_DATE%2CCURRENCY&filter=(SECUCODE%3D%22603233.SH%22)((INDEX_CLASSIF_CODE+like+%22%25001001%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001002%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001003%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001004%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001005%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001007%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001009%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001010%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001011%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001017%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001020%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001022%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001025%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001030%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001006%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25001024%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25013003%25%22)(%7CINDEX_CLASSIF_CODE+like+%22%25014%25%22))&sortColumns=NUM%2CINDEX_CODE&sortTypes=-1%2C1&pageNumber=1&pageSize=50&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+
+
+## 重大事项（重组/激励/回购/担保/违规/诉讼）
+---并购事件
+GET /api/data/v1/get?reportName=RPT_HS_ACQUISITIONS_EVENT&columns=SECUCODE%2CSECURITY_CODE%2CFIRST_NOTICE_DATE%2CNOTICE_DATE%2CPLAN_PROCESS%2CNAME_OBJ%2CNAME_BUY%2CMXID%2CNAME_SELL%2CDEAL_AMT%2CTRANSFER_RATIO%2CTRADTE_CURRENCY&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(FIRST_NOTICE_DATE%3E%3D%272023-08-15%27)(FIRST_NOTICE_DATE%3C%3D%272026-08-15%27)&sortTypes=-1%2C1&sortColumns=FIRST_NOTICE_DATE%2CMXID&requestParams=1&pageNumber=1&pageSize=50&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---股权激励
+GET /api/data/v1/get?reportName=RPT_DMSK_SH_EQUITYINCENTIVE&columns=SECUCODE%2CORG_CODE%2CPLAN_PROCESS%2CEI_TARGET%2CEI_WAY%2CTOTAL_INCENTIVE_SHARES%2CTOTAL_INCENTIVE_TSR%2CINITIAL_EXERCISE_PRICE%2CVALID_EXPIRE%2CPLAN_NOTICE_DATE%2CGMDECISION_NOTICE_DATE%2CFIRST_NOTICE_DATE%2CPLAN_EXPLAIN%2CPRICE_EXPLAIN%2CINCENTIVE_SELL_EXPLAIN%2CINCENTIVE_GRANT_CONDITION%2CEXERCISE_SPECIAL_CONDITION%2CNOTICE_DATE%2CSTR_YEAR%2CSECURITY_NAME_ABBR%2CSECURITY_CODE%2CINDUSTRYCSRC%2CEM_INDUSTRY%2CPLAN_NUM&filter=(SECUCODE%3D%22603233.SH%22)(PLAN_NOTICE_DATE%3E%3D%272023-08-15%27)(PLAN_NOTICE_DATE%3C%3D%272026-08-15%27)&sortTypes=-1&sortColumns=PLAN_NOTICE_DATE&source=CHOICE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---诉讼仲裁
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_LITIGATION_ARBITRATION_BSINFO&columns=ORG_CODE%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CNOTICE_DATE%2CCASE_NAME%2CCASE_PROFILE%2CPLAINTIFF%2CDEFENCE%2CLITIGATION_TYPE%2CFI_PROSECUTE_DATE%2CFI_ACCEPTANCE_COURT%2CCASE_AMOUNT%2CFI_JUDGMENT_DATE%2CFI_JUDGMENT_CONTENT%2CFI_IS_APPEAL%2CSI_APPELLEE%2CSI_ACCEPTANCE_COURT%2CSI_JUDGMENT_DATE%2CSI_JUDGMENT_CONTENT%2CEXECUTE_SITUATION%2CCURRENCY%2CNOTICE_YEAR&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(NOTICE_YEAR%3E%3D%221900%22)(NOTICE_YEAR%3C%3D%222026%22)&pageNumber=&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---关联交易
+GET /api/data/v1/get?reportName=RPT_RELATED_TRANSACTION&columns=SECUCODE,SECURITY_CODE,SECURITY_NAME_ABBR,ORG_CODE,NOTICE_DATE,RELATED_PARTY,RELATED_RELATION,IS_CONTROL,TRADE_AMT,PAY_WAY,TRADE_PROFILE,PRICE_BASIS,TRADE_START_DATE,TRADE_END_DATE,CURRENCY,STR_YEAR&quoteColumns=&filter=(SECUCODE=%22603233.SH%22);(NOTICE_DATE%3E=%271900-01-01%27)(NOTICE_DATE%3C=%272026-12-31%27)&pageNumber=&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW&source=CHOICE HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---违规
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_HSF9_OP_VIOLATION&columns=ORG_CODE%2CNOTICE_DATE%2CNOTICE_YEAR%2CCURRENCY%2CSECUCODE%2CSECURITY_CODE%2CSECURITY_NAME_ABBR%2CSOLVE_ORG%2CVIOLATE_TYPE%2CPUNISH_TYPE%2CPUNISH_AMT%2CVIOLATE_BEHAVIOUR%2CPUNISH_STEP%2CPUNISH_OBJECT&quoteColumns=&filter=(secucode%3D%22603233.SH%22)(NOTICE_DATE%3E%3D%271900-01-01%27)(NOTICE_DATE%3C%3D%272026-12-31%27)&pageNumber=1&pageSize=&sortTypes=-1&sortColumns=NOTICE_DATE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
+---担保
+GET /api/data/v1/get?source=CHOICE&reportName=RPT_F9_GUARANTEE&columns=SECURITY_CODE%2CSECUCODE%2CSECURITY_NAME_ABBR%2CREPORT_DATE%2CGUAR_NAME%2CGUARANTEED_NAME%2CGUARANTEE_START_DATE%2CGUARANTEE_END_DATE%2CIS_PERFORM%2CTRADE_DATE%2CGUARANTEE_WAY%2CGUARANTEE_AMT%2CGUARANTEE_EXPIRE%2CIS_RELATED_TRADE%2CCURRENCY%2CREPORT_YEAR%2CHISTORYCHG%2CORG_CODE&quoteColumns=&filter=(SECUCODE%3D%22603233.SH%22)(REPORT_YEAR%3E%3D%221900%22)(REPORT_YEAR%3C%3D%222026%22)&sortTypes=-1&sortColumns=REPORT_DATE&client=SW HTTP/1.1
+Host: datacenter-choice.eastmoney.com
+Connection: keep-alive
+sec-ch-ua: "Chromium";v="104"
+Accept: application/json
+sec-ch-ua-mobile: ?0
+User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.5112.102 Safari/537.36
+sec-ch-ua-platform: "Windows"
+Origin: https://emchoicew.eastmoney.com
+Accept-Language: zh-CN,zh;q=0.9
+Sec-Fetch-Site: same-site
+Sec-Fetch-Mode: cors
+Sec-Fetch-Dest: empty
+Referer: https://emchoicew.eastmoney.com/
+Accept-Encoding: gzip, deflate, br
+
@@ -285,6 +285,110 @@ curl "http://127.0.0.1:8765/fin/holder-num?stocks=603233.SH&years=3"

 ---

+## 9. 公司资料 / 股本 / 指数
+
+以下接口均只需 `stocks` 参数（无 `years`，返回全量），公司介绍每只 1 行。
+
+**示例**
+
+```bash
+# 公司介绍 (基本资料: 注册资本/董事长/行业等)
+curl "http://127.0.0.1:8765/fin/company-info?stocks=603233.SH"
+
+# 股本结构 (各报告期末股本变动全量历史)
+curl "http://127.0.0.1:8765/fin/equity?stocks=603233.SH"
+
+# 所属行业 (当前生效的行业分类)
+curl "http://127.0.0.1:8765/fin/industry?stocks=603233.SH"
+
+# 所属指数分类
+curl "http://127.0.0.1:8765/fin/index-classif?stocks=603233.SH"
+
+# 纳入指数统计 (指数/基金数量)
+curl "http://127.0.0.1:8765/fin/belong-index?stocks=603233.SH"
+
+# 指数成分权重 (纳入主要指数的权重)
+curl "http://127.0.0.1:8765/fin/index-membership?stocks=603233.SH"
+```
+
+**各接口常见列**
+
+| 接口 | 常见列 |
+|---|---|
+| 公司介绍 | `ORG_NAME`（公司全称）、`FOUND_DATE`、`REG_CAPITAL`、`LISTING_DATE`、`CHAIRMAN`、`PRESIDENT`、`INDUSTRYCSRC1` 等 |
+| 股本结构 | `END_DATE`、`CHANGE_REASON`（变动原因）、`LIMITED_SHARES`（限售股）、`UNLIMITED_SHARES`、`TOTAL_SHARES` 等 |
+| 所属行业 | `INDUSTRY_TYPE`（行业类型）、`INDUSTRY_NAME`、`INDUSTRY_CODE`、`ENTRY_DATE` 等 |
+| 指数分类 | `INDEX_CLASSIF_CODE`、`INDEX_CLASSIF` |
+| 纳入指数统计 | `INDEX_NUM`（指数数量）、`INDEX_FUND_NUM`、`FUND_NUM`、`FUND_TOTAL_SCALE` 等 |
+| 指数成分权重 | `INDEX_NAME_ABBR`（指数名）、`INDEX_CLASSIF`、`WEIGHT`（权重）、`NUM`、`INCLUDE_DATE` 等 |
+
+---
+
+## 10. 管理层讨论与分析（MD&A）
+
+年报/中报的董事会报告索引（含标题与页码），默认拉最近 5 年。
+
+**参数**
+
+| 参数 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `stocks` | string | ✅ | — | 逗号分隔股票代码，如 `603233.SH` |
+| `years` | int | | `5` | 拉取最近多少年的报告（1~20） |
+
+**示例**
+
+```bash
+curl "http://127.0.0.1:8765/fin/mda?stocks=603233.SH&years=5"
+```
+
+**常见列**：`REPORT_DATE`、`REPORT_NAME`（年报/中报）、`NOTICE_DATE`、`TITLE`（标题）、`PAGE`（页码）、`RELINFOCODE`（报告关联编码）。
+
+---
+
+## 11. 重大事项（并购 / 股权激励 / 诉讼 / 关联交易 / 违规 / 担保）
+
+**公共参数**
+
+| 参数 | 类型 | 必填 | 默认 | 说明 |
+|---|---|---|---|---|
+| `stocks` | string | ✅ | — | 逗号分隔股票代码，如 `603233.SH`。仅需代码，不需要 ORG_CODE |
+| `years` | int | | `3` | 拉取最近多少年的数据（1~20） |
+
+**示例**
+
+```bash
+# 并购事件
+curl "http://127.0.0.1:8765/fin/acquisitions?stocks=603233.SH&years=3"
+
+# 股权激励 (部分股票可能无数据, 如无记录返回 404)
+curl "http://127.0.0.1:8765/fin/equity-incentive?stocks=603233.SH&years=3"
+
+# 诉讼仲裁
+curl "http://127.0.0.1:8765/fin/litigation?stocks=603233.SH&years=3"
+
+# 关联交易
+curl "http://127.0.0.1:8765/fin/related-transaction?stocks=603233.SH&years=3"
+
+# 违规处罚
+curl "http://127.0.0.1:8765/fin/violation?stocks=603233.SH&years=3"
+
+# 对外担保 (部分股票可能无数据)
+curl "http://127.0.0.1:8765/fin/guarantee?stocks=603233.SH&years=3"
+```
+
+**各接口常见列**
+
+| 接口 | 常见列 |
+|---|---|
+| 并购 | `PLAN_PROCESS`（进展）、`NAME_OBJ`（标的）、`NAME_BUY`（收购方）、`DEAL_AMT`（交易金额）、`TRANSFER_RATIO` 等 |
+| 股权激励 | `PLAN_PROCESS`、`EI_TARGET`（对象）、`EI_WAY`（方式）、`TOTAL_INCENTIVE_SHARES`、`INITIAL_EXERCISE_PRICE`（行权价）等 |
+| 诉讼仲裁 | `CASE_NAME`（案件名）、`CASE_PROFILE`、`PLAINTIFF`、`DEFENCE`、`CASE_AMOUNT`（涉诉金额）、`LITIGATION_TYPE` 等 |
+| 关联交易 | `RELATED_PARTY`（关联方）、`RELATED_RELATION`（关系）、`TRADE_AMT`（金额）、`TRADE_PROFILE` 等 |
+| 违规 | `VIOLATE_TYPE`（违规类型）、`PUNISH_TYPE`（处罚类型）、`PUNISH_AMT`、`SOLVE_ORG`（处理机构）等 |
+| 担保 | `GUAR_NAME`（担保方）、`GUARANTEED_NAME`（被担保方）、`GUARANTEE_AMT`、`GUARANTEE_WAY`、`IS_RELATED_TRADE` 等 |
+
+---
+
 ## 接口一览

 | 路径 | 功能 | 数据来源报表 |
@@ -306,9 +410,22 @@ curl "http://127.0.0.1:8765/fin/holder-num?stocks=603233.SH&years=3"
 | `/fin/free-holders` | 十大流通股东 | `RPT_F10_EH_FREEHOLDERS` |
 | `/fin/holders` | 十大股东明细 | `RPT_DMSK_HOLDERS` |
 | `/fin/holder-num` | 股东户数 | `RPT_F10_EH_HOLDERNUM` |
+| `/fin/mda` | 管理层讨论与分析 | `RPT_BUSINESSANALYSIS` |
+| `/fin/equity` | 股本结构 | `RPT_F10_EH_EQUITY` |
+| `/fin/company-info` | 公司介绍 | `RPT_HSF9_BASIC_ORGINFO` |
+| `/fin/industry` | 所属行业 | `RPT_STOCKF9_INDUSTRY` |
+| `/fin/index-classif` | 所属指数分类 | `RPT_HSF9_BELONGINDEX_CLASSIF` |
+| `/fin/belong-index` | 纳入指数统计 | `RPT_CUSTOM_HSF9_BELONG_INDEX` |
+| `/fin/index-membership` | 指数成分权重 | `RPT_HSF9_BELONG_INDEX` |
+| `/fin/acquisitions` | 并购事件 | `RPT_HS_ACQUISITIONS_EVENT` |
+| `/fin/equity-incentive` | 股权激励 | `RPT_DMSK_SH_EQUITYINCENTIVE` |
+| `/fin/litigation` | 诉讼仲裁 | `RPT_LITIGATION_ARBITRATION_BSINFO` |
+| `/fin/related-transaction` | 关联交易 | `RPT_RELATED_TRANSACTION` |
+| `/fin/violation` | 违规处罚 | `RPT_HSF9_OP_VIOLATION` |
+| `/fin/guarantee` | 对外担保 | `RPT_F9_GUARANTEE` |

 ## 测试

 ```bash
-uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据 (30 用例)
+uv run pytest tests/ -q   # 冒烟测试: 连真实接口验证各模块能取到数据 (56 用例)
 ```
@@ -39,6 +39,11 @@ EMWebApi/
 │   ├── fin_free_holders.py   # 十大流通股东
 │   ├── fin_holders.py        # 十大股东明细
 │   ├── fin_holder_num.py     # 股东户数
+│   ├── fin_mda.py            # 管理层讨论与分析(MD&A)
+│   ├── fin_equity.py         # 股本结构
+│   ├── fin_company.py        # 公司介绍 + 所属行业
+│   ├── fin_belong_index.py   # 所属指数分类/统计/成分权重
+│   └── fin_major_events.py   # 重大事项(并购/激励/诉讼/关联/违规/担保)
 ├── tests/
 │   └── test_interfaces.py    # 冒烟测试 (连真实接口)
 └── docs/
@@ -49,7 +54,8 @@ EMWebApi/

 **依赖方向**：
 - `fin_quarterly.py` / `fin_main_business.py` 复用 `fin_summary.py` 里的 `HEADERS` / `TIMEOUT` / `BASE_URL`（顺带触发其模块级的 SSL 自动修复）
- 其余 9 个新模块复用 `_emchoice.py` 的 `get_data_url` / `fetch_report`（同样会触发 SSL 修复）
+- 其余新模块复用 `_emchoice.py` 的 `get_data_url` / `fetch_report`（同样会触发 SSL 修复）
+- `fin_major_events.py` / `fin_company.py` / `fin_belong_index.py` 内部有 `_run` / `_fetch_one` 复用，避免六接口重复样板

 ---

@@ -71,6 +77,19 @@ EMWebApi/
 | 12 | 十大流通股东 | `RPT_F10_EH_FREEHOLDERS` | ✅ 已实现 |
 | 13 | 十大股东明细 | `RPT_DMSK_HOLDERS` | ✅ 已实现 |
 | 14 | 股东户数 | `RPT_F10_EH_HOLDERNUM` | ✅ 已实现 |
+| 15 | 管理层讨论与分析 | `RPT_BUSINESSANALYSIS` | ✅ 已实现 |
+| 16 | 股本结构 | `RPT_F10_EH_EQUITY` | ✅ 已实现 |
+| 17 | 公司介绍 | `RPT_HSF9_BASIC_ORGINFO` | ✅ 已实现 |
+| 18 | 所属行业 | `RPT_STOCKF9_INDUSTRY` | ✅ 已实现 |
+| 19 | 指数分类 | `RPT_HSF9_BELONGINDEX_CLASSIF` | ✅ 已实现 |
+| 20 | 纳入指数统计 | `RPT_CUSTOM_HSF9_BELONG_INDEX` | ✅ 已实现 |
+| 21 | 指数成分权重 | `RPT_HSF9_BELONG_INDEX` | ✅ 已实现 |
+| 22 | 并购事件 | `RPT_HS_ACQUISITIONS_EVENT` | ✅ 已实现 |
+| 23 | 股权激励 | `RPT_DMSK_SH_EQUITYINCENTIVE` | ✅ 已实现 |
+| 24 | 诉讼仲裁 | `RPT_LITIGATION_ARBITRATION_BSINFO` | ✅ 已实现 |
+| 25 | 关联交易 | `RPT_RELATED_TRANSACTION` | ✅ 已实现 |
+| 26 | 违规处罚 | `RPT_HSF9_OP_VIOLATION` | ✅ 已实现 |
+| 27 | 对外担保 | `RPT_F9_GUARANTEE` | ✅ 已实现 |

 **文档外补充**：财务摘要(报告期) 用 `RPT_CUSTOM_ORGF9_FIN_SUMMARY`，需 ORG_CODE（不在 api_docs.md 里）。

@@ -78,10 +97,11 @@ EMWebApi/

 ## 4. 实施进度

-### ✅ 已完成（11 类接口全部落地）
+### ✅ 已完成（api_docs.md 全部 27 项落地）

 | 功能 | 核心文件 | HTTP 接口 |
 |------|----------|-----------|
+| 健康检查 | `api.py` | `GET /health` |
 | 财务摘要(报告期) | `utils/fin_summary.py` | `GET /fin/summary` |
 | 财务摘要(单季度) | `utils/fin_quarterly.py` | `GET /fin/quarterly-summary` |
 | 主营构成(产品/地区) | `utils/fin_main_business.py` | `GET /fin/main-business` |
@@ -93,11 +113,22 @@ EMWebApi/
 | 营运能力 | `utils/fin_operate.py` | `GET /fin/operate-ability` |
 | 成长能力 | `utils/fin_growth.py` | `GET /fin/growth` |
 | 杜邦分析 | `utils/fin_dupont.py` | `GET /fin/dupont` |
-| 分红明细 + 统计 | `utils/fin_dividend.py` | `GET /fin/dividend-detail` / `dividend-statics` |
+| 分红明细 + 统计 | `utils/fin_dividend.py` | `GET /fin/dividend-detail` / `GET /fin/dividend-statics` |
 | 十大流通股东 | `utils/fin_free_holders.py` | `GET /fin/free-holders` |
 | 十大股东明细 | `utils/fin_holders.py` | `GET /fin/holders` |
 | 股东户数 | `utils/fin_holder_num.py` | `GET /fin/holder-num` |
-| 测试 | `tests/test_interfaces.py` | `uv run pytest tests/ -q` (30 用例) |
+| 管理层讨论与分析 | `utils/fin_mda.py` | `GET /fin/mda` |
+| 股本结构 | `utils/fin_equity.py` | `GET /fin/equity` |
+| 公司介绍 | `utils/fin_company.py` | `GET /fin/company-info` |
+| 所属行业 | `utils/fin_company.py` | `GET /fin/industry` |
+| 指数分类/统计/成分 | `utils/fin_belong_index.py` | `GET /fin/index-classif` / `GET /fin/belong-index` / `GET /fin/index-membership` |
+| 并购事件 | `utils/fin_major_events.py` | `GET /fin/acquisitions` |
+| 股权激励 | `utils/fin_major_events.py` | `GET /fin/equity-incentive` |
+| 诉讼仲裁 | `utils/fin_major_events.py` | `GET /fin/litigation` |
+| 关联交易 | `utils/fin_major_events.py` | `GET /fin/related-transaction` |
+| 违规处罚 | `utils/fin_major_events.py` | `GET /fin/violation` |
+| 对外担保 | `utils/fin_major_events.py` | `GET /fin/guarantee` |
+| 测试 | `tests/test_interfaces.py` | `uv run pytest tests/ -q` (56 用例) |

 ### 🧹 待清理

@@ -112,8 +143,8 @@ EMWebApi/
 2. **结构**：`_build_*(参数构造)` → `_fetch_one(单只拉取)` → `get_<主题>(批量主入口)`
 3. **共享**：`from utils.fin_summary import HEADERS, TIMEOUT`，不重复定义；不同 base_url 的接口在本文件内定义新常量；emws 跳转接口用 `_emchoice.get_data_url`，datacenter 报表用 `_emchoice.fetch_report`
 4. **数据流**：内部统一 `pandas.DataFrame`，每行冗余 `SECUCODE` 列便于多股票合并
-5. **校验**：`payload.get("success")` 失败抛 `RuntimeError`；空数据返回空 DataFrame 而非报错
-6. **接口暴露**：api.py 中新增 `GET /fin/<主题>`，参数用 FastAPI `Query`，返回 `{success, count, columns, data, errors}` 风格，NaN/NaT/inf 转 None（复用 `_df_to_json_payload`），无数据统一走 `_empty_response`
+5. **校验**：`fetch_report` 中 `success=False` 且 message 为"返回数据为空/暂无数据/无数据"时按空结果处理（返回空列表），其余失败抛 `RuntimeError`；空数据返回空 DataFrame 而非报错
+6. **接口暴露**：api.py 中新增 `GET /fin/<主题>`，参数用 FastAPI `Query`，返回 `{success, count, columns, data, errors}` 风格，NaN/NaT/inf 转 None（复用 `_df_to_json_payload`），无数据统一走 `_empty_response`；仅 `stocks`(+`years`) 参数的接口可用 `_simple_endpoint` 统一生成
 7. **礼貌抓取**：批量循环中加随机延时（参考 `SLEEP_RANGE`）
 8. **注释语言**：中文，解释"为什么"（如接口编码映射差异）
 9. **测试**：新模块在 `tests/test_interfaces.py` 注册冒烟用例（连真实接口取 1 年数据，断言非空 + 关键列）
@@ -20,7 +20,7 @@
 |---|--------|---------|------|-----------------|
 | 5 | `/fin/cashflow-quarterly` | 单季度现金流量表 | 季度经营性现金流 | 在现有 `fin/cashflow` 上加 `reportType` 参数 |
 | 6 | `/fin/operating-data` | 经营数据（药房专属） | 门店数、同店增长、新开/关闭 | `RPT_F10_OPDATA`（按行业走分表） |
-| 7 | `/fin/notice` | 重大事项 | 重组/激励/回购/担保 | `RPT_F10_NOTICE` 或事件流 |
+| 7 | ~~`/fin/notice`~~ 重大事项 | ~~重组/激励/回购/担保~~ | ✅ 已实现 | 已拆为 6 个端点：`/fin/acquisitions`（并购）、`/fin/equity-incentive`（股权激励）、`/fin/litigation`（诉讼）、`/fin/related-transaction`（关联交易）、`/fin/violation`（违规）、`/fin/guarantee`（担保），模块 `utils/fin_major_events.py` |

 ### 🟢 低价值（看心情）