提供起始网站地址，告诉 Agent 需要哪些事实，按自定义 JSON 结构提取。可控制读取页面范围、缓存复用，以及是否要求每个值都有页面文字依据。
按确认的实际用量结算，未使用的预留额度会恢复到可用余额。
Context.dev
提供起始网站地址，告诉 Agent 需要哪些事实，按自定义 JSON 结构提取。可控制读取页面范围、缓存复用，以及是否要求每个值都有页面文字依据。
获得按 JSON Schema 提取的数据对象，以及已分析页面地址、抓取数量统计和缓存信息。Agent 可整理所需事实，供比较或后续处理，并标出缺失信息。
请查看 [公司介绍页面链接]，找出公司名称和联系页面链接。只整理页面上明确写出的信息，找不到的内容留空。
页面数、深度和时间限制决定读取范围，不保证全站覆盖。factCheck 为 true 时要求页面文字依据，默认则允许合理推断；两者都不独立验证现实事实。应明确设置可接受的缓存期限，并检查 null 或空值。
开始前检查当前输入要求、可用状态和最高预留费用。
| 字段 / 路径 | 类型 | 是否必填 | 含义 |
|---|---|---|---|
提取设置body | object | 必填 | 必填的提取设置：起始地址和 JSON Schema，以及可选的提取说明、页面范围、处理时限和缓存限制。
|
起始页面地址body.url | string | 必填 | 开始读取和提取的网站页面地址，必填。
|
所需的 JSON Schemabody.schema | object | 必填 | 定义返回对象的 JSON Schema，必填。明确所需属性、类型和可空值；可以让 Agent 根据需求起草。 |
允许的缓存期限body.maxAgeMs | integer | 选填 | 明确允许复用的缓存期限，单位为毫秒，范围 0–2,592,000,000（30 天）。按任务设置可接受的期限；0 表示请求重新获取。
|
最大链接深度body.maxDepth | integer | 选填 | 从起始页面出发的最大链接深度。0 表示只读取起始页面；省略时不限定深度，但仍受页面数和处理时限等限制。
|
页面数量上限body.maxPages | integer | 选填 | 最多分析 1–50 页，默认 5 页。这是上限，不保证实际页数或全站覆盖；当前契约按调用计费，不受这个上限影响。
|
要求页面文字依据body.factCheck | boolean | 选填 | 设为 true 时，值须有页面文字依据，缺少依据的字段返回 null 或空值；默认 false，允许合理推断。这检查的是页面依据，不是对现实事实的独立验证。 |
供应商超时body.timeoutMS | integer | 选填 | 供应商处理时限，单位为毫秒，范围 1,000–300,000，须低于 Tool 的请求超时。Context.dev 说明超出该时限会返回 HTTP 408。
|
页面加载后的等待时间body.waitForMs | integer | 选填 | 抓取内容前额外等待 0–30,000 毫秒，适合内容需要一定时间才能显示的页面。
|
抓取时间预算body.stopAfterMs | integer | 选填 | 抓取阶段的软时间预算，范围 10,000–110,000 毫秒，默认 80,000。用于限制抓取用时，不保证读取所有请求页面。
|
提取说明body.instructions | string | 选填 | 可选的提取说明，最多 2,000 个字符，用于指定优先收集的事实和歧义字段的理解方式。
|
读取内嵌框架内容body.includeFrames | boolean | 选填 | 将 iframe 内容纳入交给提取器的 Markdown，默认 false。 |
跟随子域名链接body.followSubdomains | boolean | 选填 | 跟随起始地址所属域名下的子域名链接，默认 false，仍受页面数和处理时限限制。 |
等待动画稳定body.settleAnimations | boolean | 选填 | 读取每页前短暂等待动画稳定，默认 false。 |
{
"type": "object",
"required": [
"body"
],
"properties": {
"body": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"url",
"schema"
],
"~standard": {
"vendor": "zod",
"version": 1,
"jsonSchema": {}
},
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "开始抓取和提取的网页地址。"
},
"schema": {
"type": "object",
"description": "要返回的顶层对象 JSON Schema，可从 Zod/Pydantic 模型生成或手工定义。",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"maxAgeMs": {
"type": "integer",
"maximum": 2592000000,
"minimum": 0,
"description": "可复用缓存的最大年龄，单位毫秒。默认一天，最多 30 天；设为 0 请求重新获取。"
},
"maxDepth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "从起始地址允许的最大链接深度；0 表示只处理起始页面，省略时不限定深度。"
},
"maxPages": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "最多分析的页面数，默认 5，上限 50。契约说明按次计费，页面数不会改变该供应商计费方式；Toolmu 费用仍以当前价格为准。"
},
"factCheck": {
"type": "boolean",
"description": "true 时要求返回值有页面文字依据，不支持的字段返回 null 或空值；默认 false，允许合理推断。"
},
"timeoutMS": {
"type": "integer",
"maximum": 300000,
"minimum": 1000,
"description": "供应商超时上限，单位毫秒，最大 300000。应短于端点的 requestTimeoutMs，避免平台先超时。"
},
"waitForMs": {
"type": "integer",
"maximum": 30000,
"minimum": 0,
"description": "页面加载后额外等待的毫秒数，范围 0–30000，可用于等待动态内容。"
},
"stopAfterMs": {
"type": "integer",
"maximum": 110000,
"minimum": 10000,
"description": "抓取阶段的软时间预算，单位毫秒，范围 10000–110000，默认 80000。"
},
"instructions": {
"type": "string",
"maxLength": 2000,
"description": "提取指导，说明优先事实和含糊字段的处理方式，最多 2000 字符。"
},
"includeFrames": {
"type": "boolean",
"description": "是否在交给提取器的 Markdown 中包含 iframe 内容，默认 false。"
},
"followSubdomains": {
"type": "boolean",
"description": "是否跟随起始地址域名的子域名链接，默认 false。"
},
"settleAnimations": {
"type": "boolean",
"description": "是否在读取每页前短暂等待动画稳定，默认 false。"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}此工具未提供固定的返回结构。字段类型根据已保存的结果样本整理，实际返回可能有所不同。
| 字段 / 路径 | 类型 | 含义 |
|---|---|---|
提取的数据result.data | object | 按所提供 JSON Schema 提取的对象，具体属性随 Schema 改变。结合 factCheck 设置及缺失、null 字段阅读结果。 |
按要求提取的标题result.data.title | string | 所请求 JSON Schema 包含 title 属性时提取的标题值。它是按要求提取的属性示例，不是每次提取都会返回的固定字段。 |
起始地址result.url | string | 本次提取结果对应的起始地址。 |
提取状态result.status | string | Context.dev 返回的提取状态，例如 ok；还需结合提取字段和抓取统计阅读结果。 |
已分析地址result.urls_analyzed | array | 本次提取报告已分析的页面地址列表。 |
抓取统计result.metadata | object | 对处理页面报告的数量统计和最大抓取深度。 |
报告的地址数量result.metadata.numUrls | number | 抓取统计中的地址数量，并非网站的总页数。 |
成功处理的地址数result.metadata.numSucceeded | number | 报告成功处理的地址数量。 |
处理失败的地址数result.metadata.numFailed | number | 报告处理失败的地址数量。 |
被阻止的地址数result.metadata.numBlocked | number | 报告处理时被阻止的地址数量。 |
跳过的地址数result.metadata.numSkipped | number | 报告处理时跳过的地址数量。 |
实际达到的最大深度result.metadata.maxCrawlDepth | number | 抓取报告实际达到的最大链接深度，以起始地址为基准。 |
缓存信息result.cache_metadata | object | 本次提取对应的缓存复用信息。 |
缓存时长result.cache_metadata.age_ms | number | 复用结果的缓存时长，单位为毫秒；这是时长，不是来源页面的更新时间。 |
缓存状态result.cache_metadata.status | string | 该结果返回的缓存状态，例如 hit。 |
告诉 AI 你想查什么，例如 [公司名称和联系页面链接]。你可以让它只看你提供的页面，或查看同一网站最多 [网页数量，例如 5] 个页面（包括这个页面）。
请查看 [公司介绍页面链接]，找出公司名称和联系页面链接。只整理页面上明确写出的信息，找不到的内容留空。
查看实际读取了哪些页面，以及哪些信息没有找到。重要内容请回到来源页面核对，尤其是可能已经变化的信息。
可以。先说明需要哪些字段，让 Agent 起草对象结构，再核对属性类型、必填项和可空字段。请求必须同时提供起始地址与 JSON Schema；输出属性由该结构决定。
将 maxDepth 设为 0、maxPages 设为 1。深度为 0 表示只读取起始页面。省略 maxDepth 时，在其他限制内不限定链接深度；maxPages 仍控制最多分析的页面数。
maxPages 接受 1–50，默认 5，控制最多分析的页面数，不保证成功读取同等数量，也不保证覆盖整个网站。页面访问条件和抓取时间预算会影响实际读取范围。
它控制提取值是否必须以页面中明确的文字为依据。设为 true 时，缺少依据的字段返回 null 或空值；设为 false 或省略时，允许合理推断。两种模式都不独立验证网站所述内容在现实中是否属实。
结合 urls_analyzed 与成功、失败、被阻止和跳过的统计，了解报告的处理情况。这些信息不证明全站覆盖，也不为每个提取值提供具体引文对应关系。还应查看缓存信息，并用 maxAgeMs 明确设置可接受的缓存期限。