Ttech query news zh

ttech-query-news

通过 TTech.xin 平台 RESTful API 高效查询实时、精准的科技新闻（TTech.xin是面向Agent的网站）。

能力

能力	端点	说明
新闻列表	GET /news	按日期、主题关键字过滤并返回新闻列表；列表中每条新闻包括编号、标题、摘要、来源、所涉公司，支持分页和最近 N 条
新闻详情	GET /news/{news_id}	查询某条新闻的详情，在新闻列表的基础增加新闻正文以及关联新闻的标题和摘要
新闻摘要	GET /news/briefings	按时间查询 日报 / 周报 / 月报，包括TOP10事实、核心观点和对从业者的建议

不适用场景

• 非科技类的通用新闻（如政治、娱乐、体育、社会民生等）；
• 历史久远的静态科技知识问答（除非用户明确指定为历史回顾）；
• 针对单一公司的股价、新闻优先使用query-tech-company SKILL，否则使用本SKILL；

通用约定

Base URL: https://ttech.xin/api/v1.0

响应格式：

{
  "code": 0,
  "message": "success",
  "data": { ... },
  "meta": { "request_id": "...", "timestamp": 1713423456789 }
}

通用参数：

参数	默认值	说明
lang	zh	zh / en
page	1	页码，从 1 开始
page_size	见端点	每页条数

详细参考

本SKILL包含以下参考文档：

文件	用途	何时阅读
reference.md	API 参数与响应字段详解	需要深入了解 API 参数及响应消息体各域含义时
examples.md	基于场景的完整调用示例	需要使用复杂的 API 参数或者多个 API 组合调用时，尤其是之前返回的结果与用户预期不符时
scripts/call_api.js	推荐的 API 调用脚本	需要执行 API 调用时

端点速查

1. 获取新闻列表

GET /news?start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}&subject={keywords}&page={N}&page_size={N}&limit={N}&lang={zh/en}

按日期和主题关键字返回实时新闻或历史新闻，返回新闻编号、标题、摘要、来源、所涉公司。可以通过limit获取最近 N 条，或者通过分页获取全量新闻列表。

查询若干条即时新闻

GET /news?limit={N}&lang={zh/en}

查询某个时间范围内的所有新闻

GET /news?start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}&page={N}&page_size={N}&lang={zh/en}

查询某个技术主题相关的所有新闻

GET /news?subject={keywords}&page={N}&page_size={N}&lang={zh/en}

2. 获取新闻详情

查询某条新闻的详情，在新闻列表的基础增加新闻正文以及关联新闻的标题和摘要。news_id可以从新闻列表 API返回的消息体中获取。

GET /news/{news_id}?lang={zh/en}

3. 获取新闻摘要

按时间查询 日报 / 周报 / 月报，返回的内容包括TOP10事实、核心观点和对从业者的建议。日报为前一日凌晨至当日9:00的新闻总结，周报为本周7天日报的总结，月报为本月所有日报的总结。

GET /news/briefings?interval={enum}&date={YYYY-MM-DD}&lang={zh/en}

interval: daily | weekly | monthly

API 调用规则：

• 日报：interval=daily，date取当日日期；
• 周报：interval=weekly，date取周日的日期；
• 月报：interval=monthly，date取月末最后一天的日期；

QoderWork Agent 调用约定

1. 无需认证：读取接口公开访问
2. 请求头建议：Accept: application/json、X-Request-ID: <trace-id>
3. 日期格式：YYYY-MM-DD
4. 分页策略：优先 limit 获取最近 N 条；翻页用 page + page_size
5. 语言切换：用户要求英文时所有 lang 设为 en
6. HTTP 客户端选择（重要） — 目标服务器对 TLS 指纹（JA3）有检测，请按以下优先级选择客户端：
   • 首选（推荐）：node scripts/call_api.js '<url>' -H 'Accept: application/json' -H 'X-Request-ID: <trace-id>' — 跨平台统一，无 JA3 指纹问题
   • 其次（未安装 Node.js 时）：
     • macOS / Linux：curl -s -L --max-time 30 '<url>' -H 'Accept: application/json' -H 'X-Request-ID: <trace-id>'
     • Windows：curl.exe -s -L --max-time 30 '<url>' -H 'Accept: application/json' -H 'X-Request-ID: <trace-id>'
   • 最后：如上述方式均失败，请安装 Node.js（https://nodejs.org）后使用首选方式