语义搜索新闻

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. 展示与用户提示

向用户展示结果时必须：

1. 每条新闻展示原站与链接：列出来源（source_site：来源站点）以及文章链接（article_url），便于用户跳转原文。
2. 数据范围提示：在结果前或结果后向用户明确提示：「以下结果仅展示当年、最近半个月以内的新闻。」
3. 固定提示词（建议复用）：「仅支持查看最近半个月以内的新闻数据。」