semantic-search-news

# 语义搜索新闻 ## 1. 接口描述 | 项目 | 说明 | |------|------| | 接口名称 | 语义搜索新闻 | | 外部接口 | `GET /api/v3/market/data/semantic-search-news` | | 请求方式 | GET | | 适用场景 | 根据搜索文字进行语义搜索，返回相关新闻列表；数据仅支持查询**当年**、**最近半个月**内的新闻 | ## 2. 请求参数 | 参数名 | 类型 | 是否必填 | 描述 | 取值示例 | 备注 | |--------|------|----------|------|----------|------| | query | string | 是 | 搜索文字 | 人工智能 | - | | limit | int | 否 | 返回条数 | 10 | 默认 10 | | year | int | 否 | 年份 | 2026 | 仅支持**当年**；数据仅保留最近半个月，用于限定搜索范围 | | start_time | string | 否 | 开始时间（含） | 2026-09-20T00:00:00+08:00 | ISO 8601 格式，用于限定搜索时间范围；无时区时按东八区解释；与 `end_time` 的跨度不得超过 3 天 | | end_time | string | 否 | 结束时间（含） | 2026-09-22T23:59:59+08:00 | ISO 8601 格式，用于限定搜索时间范围；无时区时按东八区解释；与 `start_time` 的跨度不得超过 3 天 | ## 3. 响应说明 返回 `SearchResult` 数组，按相关度排序。 ```json [ { "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`）： ```bash 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-09-20T00:00:00+08:00 --end_time 2026-09-22T23:59:59+08:00 ``` `<RUN_PY>` 为主 SKILL.md 同级的 `run.py` 绝对路径。脚本输出 JSON；本接口无需额外请求头。 ## 5. 请求示例 ``` GET /api/v3/market/data/semantic-search-news?query=人工智能&limit=10&year=2026&start_time=2026-09-20T00:00:00%2B08:00&end_time=2026-09-22T23:59:59%2B08:00 ``` ## 6. 数据范围与更新 - 数据仅支持**当年**、**最近半个月**内的新闻；`year` 用于限定搜索范围，仅支持当年。 - `start_time`、`end_time` 用于进一步限定检索时间窗口，推荐与 `year` 搭配使用；时间格式需为 ISO 8601；两者跨度不得超过 3 天，超出返回 `code=400`「时间范围不能超过3天」。 - 时区处理与 K 线脚本一致：无时区输入默认按东八区（UTC+8）解释；带时区输入会统一转换为东八区再请求。 - 具体可查时间范围与更新频率以接口返回为准。 ## 7. 展示与用户提示 向用户展示结果时**必须**： 1. **每条新闻展示原站与链接**：列出**来源**（`source_site`：来源站点）以及**文章链接**（`article_url`），便于用户跳转原文。 2. **数据范围提示**：在结果前或结果后向用户明确提示：**「以下结果仅展示当年、最近半个月以内的新闻。」** 3. **固定提示词（建议复用）**：**「仅支持查看最近半个月以内的新闻数据。」**