$npx -y skills add FTShare-Lab/FTShare-skills --skill company-hk按港股交易代码查询公司介绍(market.ft.tech)。用户问港股公司简介、公司介绍、公司名称、成立日期、注册资本、法人代表、主营业务、员工人数、公司网址、企业类型、腾讯公司介绍、00700 公司信息时使用。参数 trade_code 须带后缀如 00700.HK。
| 1 | # 查询港股公司介绍(company-hk) |
| 2 | |
| 3 | ## 1. 接口描述 |
| 4 | |
| 5 | | 项目 | 说明 | |
| 6 | |------|------| |
| 7 | | 接口名称 | 查询港股公司介绍 | |
| 8 | | 外部接口 | `/api/v1/market/data/hk/company-hk` | |
| 9 | | 请求方式 | GET | |
| 10 | | 适用场景 | 按港股交易代码查询该公司介绍,含公司名称、成立日期、注册资本、法人代表、公司简介、主营业务等 | |
| 11 | |
| 12 | ## 2. 请求参数 |
| 13 | |
| 14 | | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |
| 15 | |--------|------|----------|------|----------|------| |
| 16 | | trade_code | string | 是 | 港股交易代码 | 00700.HK | 带市场后缀,如 00700.HK | |
| 17 | |
| 18 | ## 3. 响应说明 |
| 19 | |
| 20 | 返回值为港股公司介绍对象(`CompanyHkResponse`),主要字段如下: |
| 21 | |
| 22 | | 字段名 | 类型 | 说明 | |
| 23 | |--------|------|------| |
| 24 | | security_name | String | 证券简称 | |
| 25 | | trade_code | String | 交易代码 | |
| 26 | | company_name | String | 公司名称 | |
| 27 | | company_name_en | String | 公司英文名称 | |
| 28 | | reg_date | int | 成立日期,YYYYMMDD 整数(如 `19991123`),东八区 | |
| 29 | | business_status | String | 经营状态 | |
| 30 | | reg_money | String | 注册资本(元) | |
| 31 | | currencyid | int | 币种 ID | |
| 32 | | currency | String | 币种 | |
| 33 | | legal | String | 法人代表 | |
| 34 | | reg_address | String | 注册地址 | |
| 35 | | office_address | String | 办公地址 | |
| 36 | | company_prof | String | 公司简介 | |
| 37 | | business_main | String | 主营业务 | |
| 38 | | staff_num | int | 员工人数 | |
| 39 | | website | String | 公司网址 | |
| 40 | | phone | String | 公司电话 | |
| 41 | | fax | String | 公司传真 | |
| 42 | | enterprise_type | String | 企业类型 | |
| 43 | |
| 44 | ## 4. 调用方式 |
| 45 | |
| 46 | 本 handler 与上级 `FTShare-hk-data/run.py` 配合使用: |
| 47 | |
| 48 | ```bash |
| 49 | python <RUN_PY> company-hk --trade_code 00700.HK |
| 50 | ``` |
| 51 | |
| 52 | 其中 `<RUN_PY>` 为 `FTShare-hk-data/run.py` 的绝对路径。 |
| 53 | |
| 54 | ### 直接执行 handler(调试) |
| 55 | |
| 56 | ```bash |
| 57 | python scripts/handler.py --trade_code 00700.HK |
| 58 | ``` |
| 59 | |
| 60 | (需在 `sub-skills/company-hk` 目录下执行,或传入脚本完整路径。) |
| 61 | |
| 62 | ## 5. 请求示例 |
| 63 | |
| 64 | ``` |
| 65 | GET /api/v1/market/data/hk/company-hk?trade_code=00700.HK |
| 66 | ``` |