Grok怎么只查指定网站？Web Search域名筛选、引用与来源核对

搜索一个API参数时，混进过时博客和转载很容易得出错误结论。Grok的Web Search工具支持用域名过滤收窄检索。本教程通过xAI官方API只搜索docs.x.ai，并检查返回引用是否真的支持结论，适合制作带来源的开发笔记；它与搜索X帖子是不同的工具。

第一步：准备官方API环境

需要xAI官方API账户、可用密钥及当前模型和工具访问权限。普通聊天会员或第三方平台会员不能自动代替API权限。示例采用Python requests，先安装该库，将密钥放在环境变量XAI_API_KEY中，不写进源文件。调用可能产生费用，先用一个小问题验证。

本文使用官方Web Search文档展示的grok-4.7模型与Responses接口。上线到自己的项目之前，仍需在官方控制台确认账户可用模型。不要把示例模型名改成聊天页面显示的昵称，也不要把Web Search的参数直接照搬到X Search。

第二步：限定允许检索的域名

import os, json, pathlib, requests
response = requests.post(
    "https://api.x.ai/v1/responses",
    headers={"Authorization": "Bearer " + os.environ["XAI_API_KEY"]},
    json={
        "model": "grok-4.7",
        "input": [{"role": "user", "content": "仅根据xAI官方文档，解释Web Search允许域名与排除域名的区别，给出来源，并说明不能确认之处。"}],
        "tools": [{"type": "web_search", "filters": {"allowed_domains": ["docs.x.ai"]}}]
    }, timeout=120
)
response.raise_for_status()
data = response.json()
pathlib.Path("grok-web-result.json").write_text(
    json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
for item in data.get("output", []):
    for part in item.get("content", []):
        if part.get("type") == "output_text":
            print(part.get("text", ""))
            print(json.dumps(part.get("annotations", []), ensure_ascii=False))

allowed_domains表示只允许指定域名，excluded_domains表示排除指定域名，两者不能同时使用，且各自最多支持5个域名。用域名值，不把整段搜索问题或带路径的文章地址填进去。上例的目标是限制官方文档范围，不是让工具执行任意网站动作。

第三步：核对原始返回与引用

程序保留完整JSON，同时遍历输出内容中的output_text和其annotations。先查看是否确实有搜索及引用信息，再根据返回的引用URL打开原文。没有引用的段落，应标为暂未核对；不能仅凭回答末尾出现“官方文档”几个字，就认定检索已经成功。

请将每项结论整理成：结论、引用URL、原文支持的短句、适用接口、尚未确认的范围。若来源只解释旧接口，不能用于证明新接口同样适用；找不到支持时明确写“未找到依据”。

检查链接最终落地的主机是否属于预期来源，文章是否重定向到通用首页，原文是否真的含有相应参数。域名过滤降低无关来源，但不是事实保证；同一官方网站也可能同时保留历史版本和迁移文档，必须结合页面版本与更新时间判断。

第四步：排查结果过少和时间误判

只有一个域名时结果较少，先换成明确的功能词和参数名，再检查官方站点是否另有文档主机。如需增加域名，逐项写出理由并保持在数量限制内。不要因为未检索到就宣称功能不存在；未被检索、页面更新或访问限制都可能影响结果。

域名过滤不是日期过滤，不要把X Search的日期参数塞进web_search。要判断“最近更新”，应在提示词中要求查页面日期，并打开官方更新日志复核。抓取时间和发布日是两回事；旧文被重新索引，也不会自动变成当天的新功能。

第五步：形成可复查的检索笔记

最后保留问题、使用模型、允许域名、调用日期和原始结果文件。抽查至少两条具体结论，确认来源支持后再用于教程或项目决策。若遇到401或403，先检查密钥和权限；工具参数错误则对照当前官方文档，不靠连续重试掩盖错误。

验收标准是检索范围明确、每项关键结论有可打开的官方证据、无法确认的部分单独列出。搜索回答可以帮助定位资料，但涉及接口兼容性与实际运行结果时，仍应使用自己的最小调用验证，不能把搜索生成的示例写成已经亲测通过。

官方资料

资料核对日期：2026年10月23日。

• xAI：Web Search工具与域名过滤