让 Agent 按名称、域名、证券代码或 ISIN 查询公司新闻。可用发布时间和一种筛选类别缩小范围，再阅读标题、返回的片段及发布者链接。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Context.dev
让 Agent 按名称、域名、证券代码或 ISIN 查询公司新闻。可用发布时间和一种筛选类别缩小范围，再阅读标题、返回的片段及发布者链接。
一页与目标公司相关的新闻记录，包括标题、可提供的描述或片段、发布者链接及报告的发布时间。公司相关性标签和分数帮助区分主要报道与次要提及；结果也可能提供续页游标。
查找 [公司名称，例如 Microsoft] 或 [公司官网链接，例如 https://www.microsoft.com] 的近期新闻。按发布时间从新到旧列出 [篇数，例如 5] 篇，并附上新闻标题、媒体来源、日期、原文链接及其与该公司的关联。
描述不等于文章全文。结果可能遗漏报道、日期或其他信息，发布时间也不代表事件发生日期或内容最新。相关性分数和发布者信息流标记不核实公司身份或事实准确性；本页数量不能衡量该公司的全部新闻。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
新闻查询条件body | object | 必填 | 必填查询对象，包含一家公司的标识，以及可选的条数、排序和筛选设置。
|
每页条数上限body.limit | integer | 选填 | 单页最多请求 1–100 篇文章，默认 10。实际返回可能更少，该值不是全部匹配文章的数量。
|
续页游标body.cursor | string | 选填 | 第一页不填写。续页时原样使用返回的 next_cursor，保持公司、筛选和排序不变；长度最多 300 个字符。
|
排序设置body.sortBy | object | 选填 | 可选排序对象。type 可填 newest 或 relevance，默认按 newest 排序。
|
排序方式body.sortBy.type | string | 选填 | newest 按报告的发布时间排序；relevance 按供应商判断的公司相关性排序。
|
筛选设置body.filterBy | object | 选填 | 可选日期范围，并最多搭配一种类别：articleType、sourceDomain、sourceCountry 或 articleLanguage。所选类别填写 1–3 个值。 |
发布时间范围body.filterBy.date | object | 选填 | 按报告的发布时间筛选，包含起止边界。可以只填一端；两端都填时，from 不得晚于 to。需把目标时区的日期边界换算为毫秒时间戳。 |
发布时间终点body.filterBy.date.to | integer | 选填 | 可选的发布时间终点，使用 Unix 纪元起算的毫秒时间戳，包含该时刻。
|
发布时间起点body.filterBy.date.from | integer | 选填 | 可选的发布时间起点，使用 Unix 纪元起算的毫秒时间戳，包含该时刻。
|
文章类型body.filterBy.articleType | array | 选填 | 从 editorial、press_release、regulatory_filing、advisory 中选择 1–3 项；选择此类别后，不再同时使用其他非日期筛选类别。
|
文章类型值body.filterBy.articleType[] | string | — | editorial 表示编辑报道，press_release 表示新闻稿，regulatory_filing 表示监管申报，advisory 表示咨询类内容。类型标签本身不核实文章中的事实。
|
发布者域名body.filterBy.sourceDomain | array | 选填 | 选择 1–3 个新闻发布者域名，例如 fortune.com。这里限定新闻来源，目标公司仍由公司标识指定。
|
发布者域名值body.filterBy.sourceDomain[] | string | — | 单个发布者域名字符串，长度为 1–253 个字符。
|
发布者国家body.filterBy.sourceCountry | array | 选填 | 选择 1–3 个受支持的国家代码，按新闻发布者所在国家筛选，并非按目标公司总部所在地筛选。
|
国家代码body.filterBy.sourceCountry[] | string | — | 填写一个受支持的小写国家代码：ae、ar、au、ca、cg、ch、cl、cz、de、fi、fr、gb、hk、il、in、jp、kr、mx、ng、nl、qa、sa、se、sg、us 或 za。
|
文章语言body.filterBy.articleLanguage | array | 选填 | 选择 1–3 个受支持的文章语言代码，用于筛选文章语言，并不要求翻译内容。
|
语言代码body.filterBy.articleLanguage[] | string | — | 填写一个受支持的语言代码：ar、de、en、es、fr、hi、it、ja、ko、nl、pt、ru 或 zh。
|
公司查询方式body.searchBy | object | 必填 | 必填公司查询对象。type 填 entity，并在 entity 中选择一种公司标识。
|
查询模式body.searchBy.type | string | 必填 | 固定填 entity，表示按公司实体查询。
|
公司标识body.searchBy.entity | object | 必填 | 选择一种标识组合：name 与名称、domain 与域名、ticker 与证券代码及可选交易所，或 isin 与 ISIN。只填写所选组合的字段。 |
公司名称body.searchBy.entity.nameoneOf · 1 | string | — | type 为 name 时必填，长度为 2–200 个字符。尽量提供完整名称，以便区分同名或名称相近的公司。
|
标识类型body.searchBy.entity.typeoneOf · 1 | string | — | 选择 name、domain、ticker 或 isin，决定必须填写哪一种标识字段。
|
标识类型body.searchBy.entity.typeoneOf · 2 | string | — | 选择 name、domain、ticker 或 isin，决定必须填写哪一种标识字段。
|
公司域名body.searchBy.entity.domainoneOf · 2 | string | — | type 为 domain 时必填，长度为 1–253 个字符。填写公司域名，例如 microsoft.com。
|
标识类型body.searchBy.entity.typeoneOf · 3 | string | — | 选择 name、domain、ticker 或 isin，决定必须填写哪一种标识字段。
|
证券代码body.searchBy.entity.tickeroneOf · 3 | string | — | type 为 ticker 时必填，长度为 1–20 个字符，可使用字母、数字、点或连字符。需要区分不同市场的上市证券时，可附交易所。
|
交易所body.searchBy.entity.exchangeoneOf · 3 | string | — | 仅在 type 为 ticker 时可选，长度为 2–10 个字符，例如 NASDAQ 或 LSE。
|
ISINbody.searchBy.entity.isinoneOf · 4 | string | — | type 为 isin 时必填，为 12 个字符的证券识别码。请提供目标公司对应证券的标识。
|
标识类型body.searchBy.entity.typeoneOf · 4 | string | — | 选择 name、domain、ticker 或 isin，决定必须填写哪一种标识字段。
|
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"searchBy"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "最多返回 1–100 篇文章，默认 10；这也决定预留费用，供应商每 10 篇收一个 credit。"
},
"cursor": {
"type": "string",
"maxLength": 300,
"description": "上一响应的原始 next_cursor，用于下一页；每页文章单独计费，长度最多 300。"
},
"sortBy": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"relevance",
"newest"
],
"type": "string",
"description": "排序方式：relevance 或 newest。"
}
},
"description": "结果排序，默认 newest。",
"additionalProperties": false
},
"filterBy": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "包含边界的结束发布时间，单位 Unix 毫秒。"
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "包含边界的起始发布时间，单位 Unix 毫秒。"
}
},
"description": "发布时间窗口，单位 Unix 毫秒。",
"additionalProperties": false
},
"articleType": {
"type": "array",
"items": {
"enum": [
"editorial",
"press_release",
"regulatory_filing",
"advisory"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "包含的文章类型，1–3 项，用于区分独立 editorial 与公司发布内容。"
},
"sourceDomain": {
"type": "array",
"items": {
"type": "string",
"maxLength": 253,
"minLength": 1
},
"maxItems": 3,
"minItems": 1,
"description": "包含的发布者域名，1–3 项。"
},
"sourceCountry": {
"type": "array",
"items": {
"enum": [
"ae",
"ar",
"au",
"ca",
"cg",
"ch",
"cl",
"cz",
"de",
"fi",
"fr",
"gb",
"hk",
"il",
"in",
"jp",
"kr",
"mx",
"ng",
"nl",
"qa",
"sa",
"se",
"sg",
"us",
"za"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "包含的发布者国家，1–3 个受支持的小写 ISO 两位代码。"
},
"articleLanguage": {
"type": "array",
"items": {
"enum": [
"ar",
"de",
"en",
"es",
"fr",
"hi",
"it",
"ja",
"ko",
"nl",
"pt",
"ru",
"zh"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"description": "包含的文章语言，1–3 个受支持的 ISO 639-1 代码。"
}
},
"description": "可选结果筛选。",
"additionalProperties": false
},
"searchBy": {
"type": "object",
"required": [
"type",
"entity"
],
"properties": {
"type": {
"type": "string",
"const": "entity",
"description": "查询方式，只支持 entity。"
},
"entity": {
"oneOf": [
{
"type": "object",
"required": [
"type",
"name"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "公司名称，2–200 个字符。"
},
"type": {
"type": "string",
"const": "name"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"domain"
],
"properties": {
"type": {
"type": "string",
"const": "domain"
},
"domain": {
"type": "string",
"maxLength": 253,
"minLength": 1,
"description": "公司网站域名，例如 apple.com。"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"ticker"
],
"properties": {
"type": {
"type": "string",
"const": "ticker"
},
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.-]+$",
"maxLength": 20,
"minLength": 1,
"description": "上市公司证券代码，例如 AAPL，长度 1–20，使用契约支持的字母、数字、点或连字符。"
},
"exchange": {
"type": "string",
"maxLength": 10,
"minLength": 2,
"description": "用于区分同代码的交易所，例如 NASDAQ、NYSE、LSE 或 XETRA，2–10 个字符。"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"type",
"isin"
],
"properties": {
"isin": {
"type": "string",
"pattern": "^[A-Za-z]{2}[A-Za-z0-9]{9}[0-9]$",
"description": "国际证券识别码，例如 US0378331005，使用当前输入契约接受的格式。"
},
"type": {
"type": "string",
"const": "isin"
}
},
"additionalProperties": false
}
],
"description": "公司标识，名称、域名、可附交易所的证券代码或 ISIN 四选一。"
}
},
"description": "新闻查询目标。",
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}此工具未提供固定的返回结构。字段类型根据已保存的结果样本整理，实际返回可能有所不同。
| 字段 / 路径 | 类型 | 含义 |
|---|---|---|
新闻查询结果result | object | 目标公司的一页文章记录及分页信息。 |
文章列表result.data | array | 返回的文章记录，包括标题、发布者提供的描述或片段、来源链接及公司相关性信息。 |
文章标识result.data[].id | string | 供应商的文章标识，可用于识别多次查询中出现的同一篇文章。 |
文章标题result.data[].title | string | 返回的文章标题。 |
描述或片段result.data[].description | string | 发布者提供的摘要或片段。可能很短、不完整或为 null，并非完整文章正文。 |
文章链接result.data[].url | string | 指向发布者文章的链接，便于继续阅读原文。 |
发布时间result.data[].published_at | string | 报告的 ISO 8601 发布时间，无法提供时可为 null。表示文章发布时刻，并非文中事件发生时刻。 |
报道类型result.data[].type | string | 供应商提供的类别标签：editorial、press_release、regulatory_filing 或 advisory。 |
公司相关性result.data[].match | object | 供应商对目标公司是文章主要对象还是次要提及的判断，并附相关性分数。 |
相关性级别result.data[].match.level | string | primary 表示文章主要围绕该公司；secondary 表示该公司作为次要对象被提及。 |
相关性分数result.data[].match.confidence | number | 供应商给出的 0–1 相关性分数，无法提供时可为 null。它不是公司匹配正确率，也不是文章事实准确率。 |
发布者信息result.data[].source | object | 发布者名称、域名，以及 Context 是否在发布者自己的信息流中观察到该文章。 |
发布者名称result.data[].source.name | string | 返回的出版物或新闻发布者名称。 |
发布者域名result.data[].source.domain | string | 文章发布者对应的域名。 |
发布者信息流标记result.data[].source.direct | boolean | true 表示 Context 在发布者自己的信息流中观察到该文章。此标记不证明文章事实准确。 |
署名列表result.data[].authors | array | 返回的作者署名。空列表表示该记录未提供署名。 |
文章语言result.data[].language | string | 可提供时返回的语言代码，并不表示内容经过翻译。 |
报道组标识result.data[].story_id | string | 供应商为同一天、同一事件的报道提供的分组标识，可按需要组织相关记录。 |
主图引用result.data[].image_url | string | 可提供时返回的主图 URL，并非图片文件。 |
本页文章数result.meta.count | number | 本次响应中的文章记录数量，并非全部匹配结果数量。 |
是否还有下一页result.has_more | boolean | 供应商是否报告该查询还有更多结果；此字段并不说明已覆盖所有新闻。 |
续页游标result.next_cursor | string | 可续页时提供的不透明值。需原样使用，并保持原查询、筛选和排序。 |
说明需要 [新闻篇数，例如 5] 篇，也可以说希望优先查看最新消息。
查找 [公司名称，例如 Microsoft] 或 [公司官网链接，例如 https://www.microsoft.com] 的近期新闻。按发布时间从新到旧列出 [篇数，例如 5] 篇，并附上新闻标题、媒体来源、日期、原文链接及其与该公司的关联。
点击来源链接阅读完整新闻。新闻发布日期可能与事件发生时间不同，简短说明也可能省略细节。
从公司名称、域名、证券代码或 ISIN 中选择一种。域名有助于区分名称相近的公司；证券代码可附交易所。每次请求查询一家公司的新闻，多家公司需分别查询。
发布时间范围最多搭配一种其他类别：发布者域名、发布者国家、文章语言或文章类型。所选类别填写 1–3 个值。日期使用包含边界的毫秒时间戳，起点不得晚于终点。发布者国家并非公司总部所在地；语言筛选不会翻译文章。
返回标题，以及可提供的发布者描述或片段；片段可能很短、不完整或缺失。可通过文章链接继续阅读原始来源。这个 Tool 不获取完整文章正文。
primary 表示公司是文章主要对象，secondary 表示次要提及。分数表达供应商判断的相关性，不是文章事实准确率。直接来源标记表示 Context 在发布者自己的信息流中观察到文章，并不表示已核实文章中的事实。
has_more 为 true 且存在 next_cursor 时，原样传入游标，并保持公司、筛选和排序不变。每页是独立计费调用，按已有授权和预算续页。没有更多结果、缺少游标或游标重复时停止。limit 是单页上限，count 只统计本次返回的一页。