SFC Search 金融搜索
南财金融搜索引擎,支持14个类别的关键词搜索。
接口信息
- URL:
https://terminal.sfccn.com/terminal/rest/esSearch/searchkey/page - Method: GET
- 认证: Token Header
参数说明
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
keyword |
string | 是 | 搜索关键词 |
category |
int | 是 | 搜索类别(见下表) |
pageNo |
int | 否 | 页码(默认1) |
pageSize |
int | 否 | 每页条数(默认10) |
lastId |
string | 否 | 主题库翻页用,传最后一个id |
搜索类别
| category | 名称 | 说明 | 返回结构 |
|---|---|---|---|
| 1 | 主题 | 主题库搜索 | list of 主题对象 |
| 2 | 股票 | 股票代码/名称搜索 | list of 股票对象 |
| 3 | 债券 | 债券代码/名称搜索 | list of 债券对象 |
| 4 | 资讯 | 资讯文章搜索 | list of 资讯对象 |
| 5 | 快讯 | 快讯搜索 | list of 快讯对象 |
| 6 | 舆情 | 舆情/社交媒体搜索 | list of 舆情对象 |
| 7 | 综合 | 全类别综合搜索 | dict,包含所有子类别 |
| 10 | 公司 | 公司信息搜索 | list of 公司对象 |
| 11 | 基金 | 基金代码/名称搜索 | list of 基金对象 |
| 12 | 产品 | 理财产品搜索 | list of 产品对象 |
| 13 | 研报 | 研究报告搜索 | list of 研报对象 |
| 14 | 研报图片 | 研报图表搜索 | list of 研报图片对象 |
| 15 | EDB指标数据 | 宏观经济指标搜索 | list of 指标对象 |
| 16 | 指数 | 指数代码/名称搜索 | list of 指数对象 |
各类别返回字段说明
Category 1: 主题
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 主题ID |
| theme_name | string | 主题名称(含高亮标签) |
| status | int | 状态 |
| attent | int | 关注数 |
| create_time | int | 创建时间戳 |
| update_time | int | 更新时间戳 |
| delete_flag | int | 删除标记 |
示例:
{
"id": 13312127,
"theme_name": "综合",
"status": 0,
"attent": 0,
"create_time": 1752650765000,
"update_time": 1752656297000
}
Category 2: 股票
| 字段 | 类型 | 说明 |
|---|---|---|
| security_code | string | 证券代码 |
| stock_cn_abbr | string | 中文简称(含高亮) |
| stock_cn_name | string | 中文全称 |
| stock_en_name | string | 英文名称 |
| stock_en_abbr | string | 英文简称 |
| stock_type | string | 股票类型 |
| security_mrkt | string | 市场代码 |
| company_code | string | 公司代码 |
| security_abbr | string | 证券简称 |
示例:
{
"security_code": "03395",
"stock_cn_abbr": "吉星<em>新能源</em>",
"stock_cn_name": "吉星<em>新能源</em>有限责任公司",
"stock_en_name": "JX ENERGY",
"security_mrkt": "002001",
"company_code": "80572056"
}
Category 3: 债券
| 字段 | 类型 | 说明 |
|---|---|---|
| security_code | string | 债券代码 |
| bond_cn_name | string | 债券中文名称(含高亮) |
| bond_cn_spelling | string | 拼音缩写 |
| security_mrkt | string | 市场代码 |
| company_code | string | 发行公司代码 |
| security_abbr | string | 证券简称 |
示例:
{
"security_code": "082580448",
"bond_cn_name": "电投融和<em>新能源</em>发展有限公司2025年度...",
"security_abbr": "25电投融和1ABN001(绿色)优先",
"security_mrkt": "001005"
}
Category 4: 资讯
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 资讯ID |
| title | string | 标题(含高亮) |
| content | string | 内容(HTML格式) |
| description | string | 摘要 |
| author | string | 作者 |
| catalog_id | int | 分类ID |
| date_updated | int | 更新时间戳(秒) |
| listthumb | string | 缩略图URL |
示例:
{
"id": 372220,
"title": "<em>新能源</em> 工控、<em>新能源</em>持续高景气",
"description": "浙商证券2月份以来电新板块龙头公司...",
"author": "",
"date_updated": 1616517019,
"catalog_id": 100
}
Category 5: 快讯
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 快讯ID |
| title | string | 标题(含高亮) |
| content | string | 内容(含高亮) |
| author | string | 作者/来源 |
| catalog_id | int | 分类ID |
| date_updated | int | 发布时间戳(秒) |
示例:
{
"id": 1071651,
"title": "总投资超80亿元,中欧汽车产业深化<em>新能源</em>领域合作",
"content": "南方财经5月15日电...",
"author": "21快讯",
"date_updated": 1778831415,
"catalog_id": 3
}
Category 6: 舆情
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 舆情ID |
| title | string | 标题(含高亮) |
| content | string | 内容 |
| summary | string | 摘要 |
| author | string | 来源/作者 |
| url | string | 原文链接 |
| date_created | string | 创建时间(ISO格式) |
| date_updated | string | 更新时间(ISO格式) |
| catalog_id | int | 分类ID |
| emotion_pos | int | 情绪正向标记 |
| emotion_weight | float | 情绪权重 |
| status | int | 状态 |
| products | list | 关联产品列表 |
| concepts | list | 关联概念列表 |
| industries | list | 关联行业列表 |
示例:
{
"id": 2888100,
"title": "#<em>新能源</em>赛道迎密集利好#",
"author": "A股伪解释",
"url": "https://finance.sina.com.cn/...",
"date_created": "2024-11-15T04:55:55.000Z",
"emotion_weight": 0.86,
"products": [{"product_code": "PT19642", "product_name": "人工智能"}],
"concepts": [{"concept_code": "13011424", "concept_name": "储能"}],
"industries": [{"industry_code": "sfc110303", "industry_name": "技术咨询服务"}]
}
Category 7: 综合
综合搜索返回一个 dict,包含所有子类别的结果:
| 子类别键 | 说明 |
|---|---|
| news | 资讯 |
| product | 产品 |
| index | 指数 |
| research_image | 研报图片 |
| economy | EDB指标数据 |
| bond | 债券 |
| research | 研报 |
| emotion | 舆情 |
| fund | 基金 |
| timeline | 时间线 |
| theme | 主题 |
| company | 公司 |
| stock | 股票 |
每个子类别结构为:
{
"total": 4834,
"list": [...]
}
Category 10: 公司
| 字段 | 类型 | 说明 |
|---|---|---|
| company_code | string | 公司代码 |
| company_name | string | 公司名称(含高亮) |
| market_listing | bool | 是否上市 |
示例:
{
"company_code": "10001621",
"company_name": "协合<em>新能源</em>集团有限公司",
"market_listing": true
}
Category 11: 基金
| 字段 | 类型 | 说明 |
|---|---|---|
| security_code | string | 基金代码 |
| fund_cn_name | string | 基金中文全称(含高亮) |
| security_abbr | string | 证券简称 |
| alias | string | 别名 |
| fund_man | string | 基金经理 |
| fund_company | string | 基金公司 |
示例:
{
"security_code": "017132.OF",
"fund_cn_name": "中银<em>新能源</em>产业股票型证券投资基金",
"security_abbr": "中银新能源产业股票A",
"fund_man": "阎安琪",
"fund_company": "中银基金管理有限公司"
}
Category 12: 产品
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 产品ID |
| prd_code | string | 产品代码 |
| prd_name | string | 产品名称(含高亮) |
| prd_status | string | 产品状态(存续/清算等) |
| issuer | string | 发行人 |
| reg_code | string | 登记编码 |
示例:
{
"id": 350586,
"prd_code": "EW298A",
"prd_name": "阳光红<em>新能源</em>主题A",
"prd_status": "存续",
"issuer": "光大理财有限责任公司",
"reg_code": "Z7001421000082"
}
Category 13: 研报
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 研报ID |
| report_title | string | 研报标题(含高亮) |
| report_source | string | 来源机构 |
| report_author | string | 作者 |
| report_type | string | 研报类型 |
| report_date | string | 发布日期(ISO格式) |
| report_content | string | 研报内容摘要 |
| filename | string | PDF文件路径 |
示例:
{
"id": 8302828,
"report_title": "拥抱"<em>新能源</em>加"系列研究...",
"report_source": "浙商证券",
"report_author": "李超,潘高远",
"report_type": "宏观策略",
"report_date": "2021-11-19T16:00:00.000Z",
"filename": "/yanbao/46aa1a64.../20211120/...pdf"
}
Category 14: 研报图片
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 研报ID |
| report_title | string | 研报标题 |
| report_source | string | 来源机构 |
| report_author | string | 作者 |
| report_type | string | 研报类型 |
| report_date | string | 发布日期 |
| filename | string | PDF文件路径 |
| elements | object | 图表元素 |
| elements.tables | list | 表格列表 |
| elements.figures | list | 图片列表 |
elements.tables/figures 子字段:
| 字段 | 类型 | 说明 |
|---|---|---|
| location | string | 图片路径 |
| pageNum | int | 页码 |
| bbox | list | 边界框坐标 [x1, y1, x2, y2] |
| headerCaption | string | 标题说明 |
| footerCaption | string | 脚注说明 |
示例:
{
"id": 8527886,
"report_title": "基础材料行业:2025年中正平和...",
"report_source": "华泰证券",
"report_author": "李斌",
"report_type": "行业研究",
"elements": {
"tables": [{"location": "/yanbao_layout/.../tables/...jpg", "pageNum": 11}],
"figures": [{"location": "/yanbao_layout/.../figures/...jpg", "pageNum": 17}]
}
}
Category 15: EDB指标数据
| 字段 | 类型 | 说明 |
|---|---|---|
| id | int | 指标ID |
| indic_code | string | 指标代码 |
| indic_keyno | string | 指标关键字编号 |
| indic_name | string | 指标名称(含高亮) |
| indic_name1 | string | 一级分类 |
| indic_name2 | string | 二级分类 |
| indic_name3 | string | 三级分类 |
| indic_level | int | 指标层级 |
| indic_frequency | string | 频率(日/周/月/季/年) |
| unit | string | 单位 |
| data_source | string | 数据来源 |
示例:
{
"id": 4476301,
"indic_code": "2070602239",
"indic_keyno": "S070602239",
"indic_name": "<em>新能源</em>汽车:产量:客车:广西源正...",
"indic_name1": "行业经济",
"indic_name2": "汽车",
"indic_name3": "<em>新能源</em>汽车",
"indic_frequency": "月",
"unit": "辆",
"data_source": "节能与新能源汽车网"
}
Category 16: 指数
| 字段 | 类型 | 说明 |
|---|---|---|
| security_code | string | 指数代码 |
| security_abbr | string | 指数简称(含高亮) |
| security_id | string | 证券ID |
| security_mrkt | string | 市场代码 |
| index_en_name | string | 英文名称 |
| index_cn_spelling | string | 拼音缩写 |
| index_currency | string | 币种 |
示例:
{
"security_code": "399941",
"security_abbr": "<em>新能源</em>",
"security_id": "2070000443",
"security_mrkt": "001003",
"index_en_name": "NEW ENERGY INDEX",
"index_cn_spelling": "XNY",
"index_currency": "CNY"
}
使用方式
命令行调用
# 搜索资讯(默认类别)
python skills/sfc-search/call.py "新能源"
# 搜索股票
python skills/sfc-search/call.py "新能源" -c 2
# 搜索快讯
python skills/sfc-search/call.py "新能源" -c 5
# 搜索研报
python skills/sfc-search/call.py "新能源" -c 13
# 搜索基金
python skills/sfc-search/call.py "新能源" -c 11
# 综合搜索(返回所有类别)
python skills/sfc-search/call.py "新能源" -c 7
# 分页查询
python skills/sfc-search/call.py "新能源" -c 4 -p 2 -n 20
# JSON 输出
python skills/sfc-search/call.py "新能源" -c 2 --json
# 列出所有类别
python skills/sfc-search/call.py --list-categories
Python 代码调用
from call import search
# 搜索资讯
result = search("新能源", category=4, page_size=10)
if result["ok"]:
for item in result["data"]:
print(item["title"], item.get("author", ""))
# 搜索股票
result = search("宁德时代", category=2)
if result["ok"]:
for stock in result["data"]:
print(stock["security_code"], stock["stock_cn_abbr"])
# 搜索研报
result = search("人工智能", category=13, page_size=5)
if result["ok"]:
for report in result["data"]:
print(report["report_title"], report["report_source"])
# 综合搜索
result = search("新能源", category=7)
if result["ok"]:
for sub_cat, sub_data in result["data"].items():
print(f"{sub_cat}: {sub_data['total']} 条")
# 搜索快讯
result = search("央行", category=5, page_size=20)
if result["ok"]:
for flash in result["data"]:
print(f"[{flash['date_updated']}] {flash['title']}")
触发关键词
| 触发语句 | 说明 | 推荐类别 |
|---|---|---|
| "搜索XX资讯" | 搜索资讯文章 | 4 |
| "搜索XX快讯" | 搜索快讯 | 5 |
| "查找XX股票" | 搜索股票 | 2 |
| "搜索XX研报" | 搜索研究报告 | 13 |
| "查找XX基金" | 搜索基金 | 11 |
| "搜索XX指数" | 搜索指数 | 16 |
| "搜索XX债券" | 搜索债券 | 3 |
| "搜索XX舆情" | 搜索舆情 | 6 |
| "搜索XX公司" | 搜索公司 | 10 |
| "搜索XX产品" | 搜索理财产品 | 12 |
| "搜索XX指标" | 搜索EDB指标 | 15 |
| "综合搜索XX" | 全类别搜索 | 7 |
文件输出规则
所有本技能生成的文件统一保存到 ~/.openclaw/workspace/nancai/ 目录下。
文件命名规范:search_{类别}_{关键词}_{日期}.md
注意事项
- 高亮标签:返回的文本字段中包含
<em>高亮标签,使用时需去除或替换 - 时间戳格式:资讯/快讯的时间戳为秒级 Unix 时间戳,需转换
- 综合搜索:Category 7 返回所有子类别的结果,每个子类别有独立的 total 和 list
- 分页:使用 pageNo 和 pageSize 进行分页,pageSize 建议不超过 50
- 主题翻页:Category 1 主题搜索翻页时使用 lastId 参数
配置
Token 配置与其他 SFC 技能共用,优先级:
1. 环境变量 SFC_TOKEN
2. ~/.openclaw/identity/sfc_token
3. skills/sfc-search/config.json 中的 api_key