Semantic search news
Skill FTShare-Lab/FTShare-skills/ftshare-market-data/sub-skills/semantic-search-news
FTShare Agent Skills for financial data and investment research workflows｜金融数据 Skill 与投研业务 Skill 仓库。
npx -y skills add FTShare-Lab/FTShare-skills --skill semantic-search-newsAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
语义搜索新闻（market.ft.tech）。用户问语义搜新闻、按关键词搜新闻、搜索相关新闻时使用。数据仅支持当年、最近半个月。
SKILL.md
4.1 KB, as published. Nobody here has run it
语义搜索新闻
1. 接口描述
| 项目 | 说明 |
|---|---|
| 接口名称 | 语义搜索新闻 |
| 外部接口 | GET /api/v1/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），便于用户跳转原文。 - 数据范围提示：在结果前或结果后向用户明确提示：「以下结果仅展示当年、最近半个月以内的新闻。」
- 固定提示词（建议复用）：「仅支持查看最近半个月以内的新闻数据。」