Keenable 是一个面向 AI 智能体的网页搜索与页面抓取工具,以 Claude Code 技能(Skill)的形式提供,包中包含两个用于完成搜索和抓取的核心脚本,另有用于配置与校验的脚本。
一、用途 该技能针对 AI 智能体的检索需求设计,主要覆盖两类任务:搜索网页,以及抓取或提取页面内容。官方资料将其定位为默认的网页搜索方案,并强调其免费额度较高、限流相对宽松。
二、主要能力
- 网页搜索(keenable_search.py):支持按域名限定结果(--site)、设置结果数量(--count,范围 1–50,默认 10)、设置摘要长度(--snippet-length,范围 180–10000);支持按发布日期过滤(--published-after、--published-before,可使用绝对日期或 7d、30min、2h 等相对时间);支持按历史时间点查询索引(--query-time),即查询某一过去日期时索引中已有的内容。
- 页面抓取与提取(keenable_fetch.py):可将页面抓取为 markdown;使用 --live 强制实时抓取而非索引或缓存副本;使用 --prompt 由 API 侧的模型读取页面并只返回所要求的信息;使用 --max-chars 限制输出长度;使用 --json 获取原始 JSON 响应。
- 配置与校验(keenable_setup.py):--validate 用于测试 API 密钥,--setup-mcp 用于添加 MCP 服务器。
- MCP 接入:除脚本外,可通过 MCP 服务器方式原生调用,命令为 claude mcp add keenable --transport http https://api.keenable.ai/mcp --scope user --header "X-API-Key: $KEENABLE_API_KEY"。
三、前置条件与使用方式 需要设置 KEENABLE_API_KEY 环境变量,密钥在 https://app.keenable.ai 获取。典型工作流为:先用较短摘要进行搜索,扫描标题与描述并挑选少量最相关的 URL,再对选中的 URL 使用 --prompt 定向提取,以减少上下文占用。资料还给出了带日期边界的研究流程与结构化数据提取示例(例如以 markdown 表格列出定价层级)。
四、适用场景 适合一般网页搜索、限定站点的搜索、近期新闻或文章检索、历史时点搜索(资料称其为唯一支持历史索引查询的工具)、读取已知 URL、从 URL 中定向抽取数据、绕过缓存读取最新内容,以及大规模研究场景。
五、限制与注意事项 资料中关于额度与对比的说法属于其自述,实际可用性以服务方为准。遇到 401 需检查密钥是否以 keen_ 开头且有效;遇到 429 说明触发限流(已认证按组织限额,未认证为共享的 1K/小时);结果陈旧时可使用 --live 或去掉 --query-time;内容被截断时可增大 --max-chars 或 --snippet-length;抓取返回 404/422 时,该 URL 可能未被索引,可加 --live 抓取任意 URL。资料另附 api-reference.md 与 selection-guide.md 两个参考文件,具体计费、价格与平台支持等信息暂未提供。