Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mercury-eab3b728.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
网页工具接口

网页工具接口位于 /v1 下，但不要求请求体中传入模型名称。路由直接进入工具类 relay，适合在 Agent 工作流中补充网页读取和搜索能力。

​
网页读取

POST /v1/web-reader/read
​
url
string
required
需要读取的网页 URL。
​
format
string
期望输出格式，例如 markdown、md、text、txt。默认通常为 md。
​
liteMode
boolean
是否启用精简模式。
​
includeImages
boolean
是否在读取结果中包含图片信息。
​
onlyCSSSelectors
array<string>
只保留匹配指定 CSS 选择器的元素。
​
waitForCSSSelectors
array<string>
等待指定 CSS 选择器出现后再解析页面。
​
excludeCSSSelectors
array<string>
排除匹配指定 CSS 选择器的元素。
​
linkSummary
boolean
是否把页面链接汇总到内容末尾。
​
ignoreCache
boolean
是否忽略缓存并重新读取。
​
readTimeout
integer
页面读取超时时间，单位为秒。
​
topic
string
只提取与指定主题相关的内容。
curl -X POST https://www.geeknow.top/v1/web-reader/read \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/blog/api-gateway",
    "format": "markdown",
    "includeImages": true,
    "readTimeout": 20
  }'

​
网页搜索

POST /v1/web-search/search
​
query
string
required
搜索关键词或自然语言问题。
​
area
string
搜索地区，例如 global、cn。默认通常为 global。
​
freshness
string
结果时效性，例如 Day、Week、Month、Year。
​
includeImages
boolean
是否同时返回图片搜索结果。
​
page
integer
页码，默认通常为 1。
​
count
integer
每页结果数量，常用范围 1 到 50。
​
format
string
返回格式，例如 json、markdown、md、text、txt。
curl -X POST https://www.geeknow.top/v1/web-search/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "OpenAI Responses API 多模态 工具调用",
    "area": "global",
    "count": 5,
    "format": "json"
  }'

​
响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "webPages": [
      {
        "name": "Responses API guide",
        "url": "https://example.com/responses-guide",
        "displayUrl": "example.com/responses-guide",
        "snippet": "Responses API supports multimodal input and tool calls.",
        "summary": "A short guide about multimodal input and tool calls.",
        "siteName": "Example"
      }
    ]
  },
  "requestId": "req_abc123"
}

​
相关接口