Ttech query company zh

ttech-query-company

通过 TTech.xin 平台 RESTful API 查询科技公司信息。

能力

能力	端点	说明
公司列表	GET /companies	根据公司名称模糊搜索获得公司ID，或者获取全量公司列表
公司详情	GET /companies/{company_id}	公司全名、上市地点、上市代码、有竞争和合作的相关公司
股票数据	GET /companies/{company_id}/stock	日/月/年粒度股价和交易量数据
公司新闻	GET /companies/{company_id}/news	该公司及其相关公司的近期新闻

不适用场景

• 非科技类的公司（如餐饮、零售、传统制造、娱乐传媒等非科技主导行业的公司信）；
• 行业宏观新闻或无特定主体的头条：如“今天科技圈发生了什么？”、“AI 行业的最新趋势”，这类通用资讯应调用 query-tech-news 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 /companies?page={N}&page_size={N}&company_name={keyword}&lang={zh/en}

获取平台收录的全量科技公司

GET /companies?page={N}&page_size={N}&lang={zh/en}

根据公司名称搜索公司ID

GET /companies?company_name={keyword}&lang={zh/en}

• 这是所有后续查询的前置步骤，除非已知 company_id，否则必须先调用此接口；
• 有可能匹配到多条记录，需Agent从中挑出最匹配的。匹配到的记录数取决于 keyword 的精确程度；

2. 获取公司详情

GET /companies/{company_id}?lang={zh/en}

返回的公司详情，包括如下信息：

• 公司名称和ID；
• 公司全名；
• 公司上市地或交易所代码；
• 公司股票代码；
• 有竞争或合作的相关公司组成的数组，每个相关公司包括公司名称和ID；

3. 获取公司股票数据

GET /companies/{company_id}/stock?interval={enum}&limit={N}&lang={zh/en}

interval: daily | monthly | yearly 返回由股票数据组成的数组，数组中每条股票数据包含如下信息：

• 日期；
• 开盘价；
• 收盘价；
• 最高价；
• 最低价；
• 交易量；

获取若干个交易日的股票数据（日线）

GET /companies/{company_id}/stock?interval=daily&limit={N}&lang={zh/en}

获取若干月的股票数据（月线）

GET /companies/{company_id}/stock?interval=monthly&limit={N}&lang={zh/en}

获取若干年的股票数据（年线）

GET /companies/{company_id}/stock?interval=yearly&limit={N}&lang={zh/en}

4. 获取公司及其相关公司的新闻

GET /companies/{company_id}/news?lang={zh/en}

返回由本公司新闻组成的数组和相关公司新闻组成的数组。数组中每条新闻包含如下信息：

• 新闻ID，可以通过query-tech-news SKILL 获取该新闻的详细信息；
• 新闻标题；
• 新闻概要；
• 新闻来源；
• 新闻作者；
• 新闻发布时间；
• 新闻所涉公司的名称和ID；

QoderWork Agent 调用约定

1. 无需认证：读取接口公开访问
2. 请求头建议：Accept: application/json、X-Request-ID: <trace-id>
3. 两步查询模式 如果只有公司名称没有 company_id，必须先调用 GET /companies?company_name={name}&page=1&page_size=1 搜索获取 公司ID，再用 公司ID 查询详情/股票/新闻
4. 语言切换：用户要求英文时所有 lang 设为 en
5. 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>'
   • 最后：如上述方式均失败（尤其是 macOS 遇到连接重置），请安装 Node.js（https://nodejs.org）后使用首选方式