Codex 第 37 课:你的 Codex 什么都搜不到,不是模型不行,而是搜索接口没配好
从零开始掌握 OpenAI Codex——AI 编程工程 Agent。14 章覆盖认识 Codex、四种入口安装、核心功能(自动化/插件/Skill/MCP/Git/记忆)、标准工作流、实战案例和第三方模型接入。
为什么别人的 Codex 能搜到知乎、X、B站、GitHub,你的却只能翻出几篇普通网页?
差别往往不在模型,而在搜索入口有没有配好。
我把自己电脑上长期在用的搜索能力,整理成了一个开源工具:Agent Search Kit 。
装好以后,Codex、Claude Code、Kimi 和 Grok 可以共用一套本机搜索入口。你让它找教程、查产品、搜真实使用经验时,它会根据问题去不同的平台找,同时明确告诉你哪些渠道没搜到、为什么没搜到。
一、问题不在“联网”,而在搜索入口
我们平时说“让 AI 联网”,很容易把这件事理解成:它能打开网页就够了。其实远远不够。
普通网页搜索能找到官网和公开文章,但大量真正有用的信息散落在平台内部:知乎的真实回答、公众号文章、GitHub Issue、Reddit 评论、X 的讨论串、B站和 YouTube 教程、小红书里的实际体验。
这些平台的搜索方式、登录状态和返回格式都不一样。如果 Agent 不知道入口,它不会告诉你“这一块我没搜到”。很多时候,它只是拿手边能找到的几篇内容,拼成一个看起来完整的答案。
它不是一个新的搜索引擎,更像是一张给 Agent 用的搜索路线图。
二、这套方案到底能搜哪些平台
默认覆盖的高价值入口
- 官网和代码: 普通网页、官方文档、GitHub、Stack Overflow、Hugging Face
- 中文内容: 知乎、公众号、B站、小红书、V2EX
- 海外讨论: X、Reddit、Hacker News、YouTube
- 长期信源: RSS
按题目再开启的入口
- 抖音:中文短视频案例和创作者趋势
- Product Hunt:新产品发现
- 掘金:中文开发内容补充
- Gitee:中国开发生态和国内镜像
- TikTok:保留实验入口,本轮探针超时,暂不算已验收
没有为了“看起来很全”硬塞进去的渠道
LinkedIn、雪球、Instagram、Facebook、学术数据库和播客转录,我没有放进默认流程。平时使用频率低,登录和处理成本又高,投入产出不划算,需要时再接就够了。
三、这些搜索入口从哪里来
1. 官方开放的 CLI 或 API
比如知乎开放的官方 CLI。它和你自己在知乎里搜索本质上是一回事,只是把中间操作交给 Agent 自动完成。官方入口通常结构更稳定,来源也更清楚。
2. 成熟的开源工具和网站适配器
比如 OpenCLI、Agent Reach。它们把 X、YouTube、小红书、Reddit、公众号等网站的只读能力变成 Agent 能调用的命令,并复用你自己电脑上的登录状态。
3. 公开网页、官方文档和公开 API
这些入口不一定需要登录,适合查事实、代码、版本、价格和长期订阅的信源。
四、Agent 会怎么选择搜索渠道
- 查官方功能、版本、价格:先找官网和官方文档
- 找教程:补 GitHub、Stack Overflow、知乎、公众号、YouTube、B站
- 看真实使用体验:去 Reddit、Hacker News、X、小红书、V2EX
- 找模型和数据集:再去 Hugging Face
同样让 Agent 搜“最近有哪些 AI Agent 教程值得看”,配置完整的人能拿到 GitHub 项目、知乎经验、公众号长文、X 上的作者讨论、YouTube 和 B站教程、Reddit 里的踩坑记录;没有配置入口的人,往往只拿到几篇普通网页。
五、我刻意保留的安全边界
- 不会复制 Cookie、Token、知乎 Access Secret 或浏览器资料
- 账号仍然由你自己登录,凭据留在本机
- 只安装一份搜索 Skill,让 Codex、Claude Code、Kimi 和 Grok 共同读取
- 不会把四个 Agent 各自复制一份配置,避免版本漂移
失败不能被假装成“没有结果”
工具会区分:真的搜到了、正常搜索但没有结果、没有登录、接口异常、被限流、只能搜到部分公开索引。
接口报错不等于“网上没有”,微信公众号公开搜索也不等于搜遍了微信。
六、为什么视频不默认下载和转录
搜索 YouTube、B站、小红书或抖音时,先只拿标题、作者、简介、时间、时长和链接。
等我自己看过,确认某个视频确实有价值,再让 Agent 处理那个视频的字幕、语音识别或 OCR。否则一次普通搜索就触发下载、转录、抽帧,速度会慢很多,成本也没必要。
默认先搜元数据;只有确认高价值的视频,才进入字幕、ASR 和 OCR 重流程。
七、怎么安装
项目地址:https://github.com/aaronyi97/agent-search-kit
- 把上面的 GitHub 仓库链接发给你电脑上的 Agent
- 让它严格按照根目录的 AGENT_INSTALL.md 完成安装和验收
- 干净环境会从固定 Release 包安装共享搜索路由,并运行离线体检
- 如果检测到旧 agent-reach 路由、未知同名目录、账号登录或授权需求,它会停下来向你确认,不会强行覆盖
你不用自己复制命令。把仓库链接发给 Agent,让它按安装说明执行即可。
八、我在自己的 Mac 上验收了什么
已经跑过只读探针
- 知乎、公众号、X、YouTube、B站、小红书、Reddit
- Hacker News、Stack Overflow、Hugging Face、GitHub
- V2EX、RSS、抖音、Product Hunt、掘金、Gitee
还没有算进可用平台
- TikTok:本轮探针超时,所以明确标成“未验收”
九、它能做到什么,不能做到什么
能做到的
- 让 Agent 根据问题选择更合适的平台,而不是只搜普通网页
- 提高教程、代码、社区经验和产品信息的覆盖面
- 把未登录、接口异常、限流和部分索引明确说出来
- 让四个本机 Agent 共用一套搜索路由
不能做到的
- 拿不到私密内容、已删除内容、付费墙和平台没有索引的内容
- 无法绕过登录过期、平台风控、地区限制和接口限额
- 不能保证每个平台、每次搜索都返回完整结果
它能做的,是把每个可用入口接好,把失败说清楚,尽量不让 Agent 用三篇普通网页假装搜遍全网。
最后
搜索不是 Agent 的一个小功能,而是整个 AI 协作体系的地基。
模型再强,如果输入的信息少了一半,后面的总结、判断和创作都会建立在残缺材料上。把搜索入口配好,未必是最炫的配置,但可能是最值得先做的一步。
项目:Agent Search Kit https://github.com/aaronyi97/agent-search-kit
原文信息
作者:@AaronYiaazw 原文地址:https://x.com/AaronYiaazw/status/2088960999110131834