FastAPI - FastAPI
fastapi.tiangolo.com
Search API · 小范围内测
为 AI Agent 提供可追溯的网页搜索
一个 API 完成多来源与垂直检索、严格学术检索、网页和文档提取、受限站点抓取与证据研究。适用于 Codex、Claude Code 与自动化工作流。
在 GitHub 查看 Agent Skill- 多来源与学术检索
- Search-only Key
- 来源与降级透明
- 安全正文提取
POST/v1/searchbalanced
{
"query": "FastAPI official documentation",
"limit": 5,
"mode": "balanced"
}FastAPI - FastAPI - tiangolo
fastapi.tiangolo.com/ko
Multi-source按可用性聚合检索来源
Provenance每条结果保留来源与引擎
Isolated搜索 Key 不含模型权限
Protected正文提取拦截内网地址
Capabilities
从找到链接，到交付 Agent 可用的上下文
统一返回结构化 JSON，并明确告诉调用方本次用了哪些来源、是否降级、结果是否来自缓存。
01
POST /search聚合与学术检索
并行检索、清洗摘要、规范化 URL，并通过可解释的检索评分融合重复结果。
- fast / balanced / deep
- academic-strict / academic-relaxed
- DOI、作者、年份与开放 PDF
02
POST /batch-search批量检索
一次提交最多五个查询，适合竞品对比、事实核查和多方向研究。
- 统一模式与新鲜度参数
- 保留各查询独立结果
03
POST /fetch · /map · /crawl安全内容提取
提取 HTML、PDF、Office 与 GitHub 仓库内容，并提供同域、低深度的静态 Map/Crawl。
- 连接时固定已验证公网 IP
- 字节、页数、深度、并发和时间限制
04
POST /research证据研究资料包
并行执行根问题与子问题，合并交叉结果，抓取原文并生成引用编号、证据矩阵和缺口提示。
- 多查询覆盖率与来源降级提示
- 逐文档 SHA-256 与直接 URL
Developer Experience
几行代码，让 Agent 接入网页
沿用熟悉的 Bearer Key 和 JSON 请求。Base URL 与模型接口一致，搜索使用独立的精确路径。
Base URL
https://api.aifinderkit.com/v1- 依赖最少，curl 即可调用
- 适配 Python、Codex、Claude Code
- 错误、来源、缓存状态可编程处理
RESPONSEapplication/json
{
"result_count": 3,
"sources_used": ["searxng", "bing-rss"],
"warnings": [],
"cached": false,
"results": [{
"title": "FastAPI - FastAPI",
"url": "https://fastapi.tiangolo.com/",
"sources": ["bing-rss"],
"retrieval_score": 0.89,
"retrieval_signals": {
"query_relevance": 1.0,
"source_authority": 0.9
}
}]
}How it works
请求进去，证据出来
- 1
提交查询
选择速度、深度、新鲜度和结果数量。
- 2
多源检索
根据权限与可用性并行调用允许的来源。
- 3
清洗融合
规范链接、去重，并融合不同来源排名。
- 4
结构化返回
返回结果、来源、警告、时间和缓存状态。
Agent Skill
不想重复写接入代码？直接安装 Skill
内置 Search、Domains、Batch、Fetch、Map、Crawl、Research、Meta、Doctor 和安全凭据配置。学术预设可返回 DOI、作者、年份与合法开放 PDF；压缩包不包含密钥。
- 下载并解压到 Skills 目录
- 运行
configure安全保存 Key - 运行
doctor验证接入
公开源码由 AI Finder Kit Organization 维护 · ZIP SHA-256 d065fec838eff5dfcea089c56360c36be820bd3a800e5663b832f9c374f583d7 · 校验文件
Codex~/.codex/skills/aifinderkit-search
Claude Code~/.claude/skills/aifinderkit-search
# 配置 Key（下载包不包含凭证）
python ~/.codex/skills/aifinderkit-search/\
scripts/aifinderkit_search.py configure
# 首次安装后验证
python ~/.codex/skills/aifinderkit-search/\
scripts/aifinderkit_search.py doctor~/.codex/skills 替换为 ~/.claude/skills。新会话会自动发现 Skill。Security & transparency
让 Agent 知道数据从哪里来，也限制它能去哪里
权限隔离
内测申请发放搜索专用 Key，不包含任何模型调用权限。
网络边界
在实际连接时固定已验证公网 IP，忽略环境代理，并重新校验每次跳转。
来源透明
返回 sources、engines、warnings、cached 和 created_at，方便 Agent 判断证据质量。
摘要存储
搜索 Key 只保存不可逆摘要；Skill 和公开下载包中不包含密钥。
Limited private beta
申请搜索 API 内测
优先面向个人研究、跨设备调用和 Agent 工作流。申请经人工审核后发放独立的搜索专用 Key。
- 1提交使用场景
- 2人工审核内测范围
- 3通过邮箱交付 Search-only Key
请勿提交密码、现有 API Key 或其他敏感信息。
FAQ
常见问题
搜索 Key 能调用模型吗？
不能。内测申请发放的是搜索专用 Key，模型权限与搜索权限分离。
可以在 Codex 或 Claude Code 中使用吗？
可以。可直接调用 JSON API，也可以下载页面提供的 Agent Skill，通过环境变量配置 Key。
搜索结果会说明来源吗？
会。每条结果包含 sources 和 engines，顶层响应还包含 sources_used、warnings、cached 与创建时间。
为什么需要人工审核？
当前属于小范围内测，需要控制资源使用并确认使用场景与现阶段能力匹配。