FTShare-Lab 语义搜索新闻
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 语义搜索新闻 |
| 外部接口 | GET /api/v3/market/data/semantic-search-news |
| 请求方式 | GET |
| 适用场景 | 根据搜索文字进行语义搜索，返回相关新闻列表；数据仅支持查询当年、最近半个月内的新闻 |
2. 请求参数
| 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 |
|---|---|---|---|---|---|
| query | string | 是 | 搜索文字 | 人工智能 | - |
| limit | int | 否 | 返回条数 | 10 | 默认 10 |
| year | int | 否 | 年份 | 2026 | 仅支持当年；数据仅保留最近半个月，用于限定搜索范围 |
| start_time | string | 否 | 开始时间（含） | 2026-03-01T00:00:00+08:00 | ISO 8601 格式，用于限定搜索时间范围；无时区时按东八区解释 |
| end_time | string | 否 | 结束时间（含） | 2026-03-15T23:59:59+08:00 | ISO 8601 格式，用于限定搜索时间范围；无时区时按东八区解释 |
3. 响应说明
返回 SearchResult 数组，按相关度排序。
[
{
"news_id": 556106924001595392,
"source_site": "21经济网_要闻",
"article_url": "https://...",
"publish_time": "2026-03-15T21:00:00",
"fetch_time": "2026-03-15T21:19:49",
"title": "越是AI，越需人文",
"media_name": "21世纪经济",
"summary": null,
"content": "...",
"is_truncated": 0,
"is_reviewed": 1,
"score": 0.6933832764625549
}
]
SearchResult 结构
| 字段名 | 类型 | 是否可为空 | 说明 |
|---|---|---|---|
| news_id | long | 否 | 新闻 ID |
| source_site | string | 否 | 来源站点 |
| article_url | string | 是 | 文章链接 |
| publish_time | string | 是 | 发布时间，ISO 8601 格式 |
| fetch_time | string | 否 | 抓取时间，ISO 8601 格式 |
| title | string | 是 | 标题 |
| media_name | string | 是 | 媒体名称 |
| summary | string | 是 | 摘要 |
| content | string | 否 | 正文内容 |
| is_truncated | int | 否 | 是否被截断：0=否 1=是 |
| is_reviewed | int | 否 | 是否已审核：0=否 1=是 |
| score | float | 否 | 搜索匹配分数 |
4. 用法
通过主目录 run.py 调用（必填 --query，可选 --limit、--year、--start_time、--end_time）：
python <RUN_PY> semantic-search-news --query 人工智能
python <RUN_PY> semantic-search-news --query 人工智能 --limit 10 --year 2026
python <RUN_PY> semantic-search-news --query 人工智能 --limit 10 --year 2026 --start_time 2026-03-01T00:00:00+08:00 --end_time 2026-03-15T23:59:59+08:00
<RUN_PY> 为主 SKILL.md 同级的 run.py 绝对路径。脚本输出 JSON；本接口无需额外请求头。
5. 请求示例
GET /api/v1/market/data/semantic-search-news?query=人工智能&limit=10&year=2026&start_time=2026-03-01T00:00:00%2B08:00&end_time=2026-03-15T23:59:59%2B08:00
6. 数据范围与更新
- 数据仅支持当年、最近半个月内的新闻；
year用于限定搜索范围，仅支持当年。 start_time、end_time用于进一步限定检索时间窗口，推荐与year搭配使用；时间格式需为 ISO 8601。- 时区处理与 K 线脚本一致：无时区输入默认按东八区（UTC+8）解释；带时区输入会统一转换为东八区再请求。
- 具体可查时间范围与更新频率以接口返回为准。
7. 展示与用户提示
向用户展示结果时必须：
- 每条新闻展示原站与链接：列出来源（
source_site：来源站点）以及文章链接（article_url），便于用户跳转原文。 - 数据范围提示：在结果前或结果后向用户明确提示：「以下结果仅展示当年、最近半个月以内的新闻。」
- 固定提示词（建议复用）：「仅支持查看最近半个月以内的新闻数据。」