Back to Details

keenable-web-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Keenable Web Search 🔎

Keenable 网页搜索 🔎

A web search and research skill. It searches the live web for current, citable information and returns ranked results with titles, URLs, and snippets. A small bundled Python script (standard library only) calls Keenable's keyless public endpoint, so there is no API key and nothing to install.
一个网页搜索与研究 skill。它会搜索实时网络，获取当前、可引用的信息，并返回按相关性排序的结果，包括标题、URL 和摘要。一个小型内置 Python 脚本（仅使用标准库）会调用 Keenable 的免密钥公共端点，因此无需 API key，也无需安装任何东西。

What this skill is for

此 skill 的用途

Use it whenever the answer depends on information from the web rather than the model's training data:
  • Research — find papers, primary sources, and background on a topic, then read the most relevant pages before drawing conclusions.
  • News and current events — look up recent announcements, releases, and developments, with optional date bounds for time-sensitive topics.
  • Fact-checking and citation — confirm a claim against a primary source and cite the URL.
  • Company, product, and market research — gather references about an organization, product, technology, or trend.
  • Documentation lookup — find official docs, changelogs, and references for a library, standard, or API.
只要答案依赖网络信息而非模型的训练数据，就应使用它：
  • 研究 —— 查找论文、一手来源和某个主题的背景资料，然后阅读最相关的页面，再得出结论。
  • 新闻与时事 —— 查询近期公告、版本发布和最新进展，可针对时效性话题设置日期范围。
  • 事实核查与引用 —— 根据一手来源确认说法，并引用 URL。
  • 公司、产品与市场研究 —— 收集有关组织、产品、技术或趋势的参考资料。
  • 文档查询 —— 查找库、标准或 API 的官方文档、变更日志和参考资料。

Usage

使用方法

Run the bundled script with a natural-language query (describe the ideal page, not bare keywords):
bash
python3 scripts/search.py "official changelog for the EU AI Act 2025 amendments"
Snippets are starting points. Open the most relevant URL (e.g. with the agent's web-fetch tool) before relying on a claim, and cite the source.
使用自然语言查询运行内置脚本（描述理想的页面，而不是只输入关键词）：
bash
python3 scripts/search.py "official changelog for the EU AI Act 2025 amendments"
摘要只是起点。在依赖某个说法之前，请打开最相关的 URL（例如使用 agent 的 web-fetch 工具），并引用来源。

Options

选项

FlagWhat it does
--site <domain>
Restrict the search to one site, e.g. 
--site arxiv.org
.
--exclude-domain <host>
Never return results from these hosts or their subdomains. Repeatable, and accepts comma lists: 
--exclude-domain pinterest.com,quora.com --exclude-domain reddit.com
.
--published-after
/ 
--published-before
YYYY-MM-DD
bounds on publish date, for time-sensitive research.
--acquired-after
/ 
--acquired-before
YYYY-MM-DD
bounds on when the page was indexed.
--json
Raw JSON instead of formatted text.
Use 
--site
for a single site. Use 
--exclude-domain
to drop known-noisy sites from an otherwise open search. Hosts only, each covering its subdomains (
yahoo.com
covers 
finance.yahoo.com
); up to 1,000 distinct hosts (2,000 entries as sent, 2,048 bytes each). The API rejects anything else with a 400 
invalid_filter
error naming the entry. The full rules are in the README.
The script splits every value on commas and sends each trimmed piece, blank ones included, so 
--exclude-domain ""
or 
a.com,
fails with 
invalid_filter
instead of searching unfiltered. A URL with commas in its query is split too and fails the same way, on purpose: pass the host. If every result is excluded, the output can be empty. If the output starts with a 
Note:
line, the API returned a 
warning
; read it before relying on the results.
标志作用
--site <domain>
将搜索限制在一个站点内，例如 
--site arxiv.org
。
--exclude-domain <host>
绝不返回这些主机或其子域名。可重复使用，并接受逗号列表：
--exclude-domain pinterest.com,quora.com --exclude-domain reddit.com
。
--published-after
/ 
--published-before
以 
YYYY-MM-DD
格式设置发布日期范围，用于时效性研究。
--acquired-after
/ 
--acquired-before
以 
YYYY-MM-DD
格式设置页面被索引的时间范围。
--json
输出原始 JSON，而不是格式化文本。
使用 
--site
限定单个站点。使用 
--exclude-domain
从开放式搜索中排除已知噪声站点。仅接受主机名，每个主机名涵盖其子域名（
yahoo.com
涵盖 
finance.yahoo.com
）；最多支持 1,000 个不同主机（发送时最多 2,000 个条目，每个 2,048 字节）。API 会拒绝其他任何内容，并返回 400 
invalid_filter
错误以及导致错误的条目。完整规则见 README。
脚本会按逗号拆分每个值，并发送每个去除首尾空白的片段，包括空白片段。因此，
--exclude-domain ""
或 
a.com,
会以 
invalid_filter
失败，而不是执行无过滤搜索。查询中包含逗号的 URL 也会被拆分，并以相同方式失败；这是有意为之：请传入主机名。
如果所有结果都被排除，输出可能为空。 如果输出以 
Note:
行开头，说明 API 返回了 
warning
；在依赖这些结果之前，请先阅读该警告。

Examples

示例

bash
undefined
bash
undefined

News and current events

News and current events

python3 scripts/search.py "latest OpenAI model announcements"
python3 scripts/search.py "latest OpenAI model announcements"

Research papers from one site, recent only

Research papers from one site, recent only

python3 scripts/search.py "diffusion models for inverse problems"
--site arxiv.org --published-after 2025-01-01
python3 scripts/search.py "diffusion models for inverse problems"
--site arxiv.org --published-after 2025-01-01

Open search minus noisy sites

Open search minus noisy sites

python3 scripts/search.py "rust async runtime comparison"
--exclude-domain pinterest.com,quora.com
python3 scripts/search.py "rust async runtime comparison"
--exclude-domain pinterest.com,quora.com

Documentation lookup

Documentation lookup

python3 scripts/search.py "Python asyncio TaskGroup reference"
python3 scripts/search.py "Python asyncio TaskGroup reference"

Machine-readable output for downstream processing

Machine-readable output for downstream processing

python3 scripts/search.py "EU AI Act timeline" --json
undefined
python3 scripts/search.py "EU AI Act timeline" --json
undefined

Notes

说明

  • Keyless. The script calls the public search endpoint and tags traffic with an 
    X-Keenable-Title
    header; no signup or key is required. The endpoint is rate-limited — on a 
    429
    the script tells you to retry shortly.
  • No dependencies. Pure Python standard library (
    urllib
    ), so it runs anywhere Python 3 is available — nothing to 
    pip install
    .
  • More about Keenable: keenable.ai.
  • 无需密钥。 脚本会调用公共搜索端点，并通过 
    X-Keenable-Title
    请求头标记流量；无需注册或密钥。该端点存在速率限制——遇到 
    429
    时，脚本会提示稍后重试。
  • 无依赖。 纯 Python 标准库（
    urllib
    ），因此在任何提供 Python 3 的环境中都能运行——无需执行 
    pip install
    。
  • 了解 Keenable 的更多信息：keenable.ai。