Agent Skills › rcarmo/piclaw › web-search-summary

web-search-summary

GitHub

通过 SearXNG 或 DuckDuckGo 执行网络搜索，获取前几条结果并生成句子级摘要及可选的页面内容转换。

skel/.pi/skills/web-search-summary/SKILL.md rcarmo/piclaw

Trigger Scenarios

需要快速了解网页核心内容的场景批量获取搜索结果摘要而非全文的场景

Install

npx skills add rcarmo/piclaw --skill web-search-summary -g -y

More Options

Non-standard path

npx skills add https://github.com/rcarmo/piclaw/tree/main/skel/.pi/skills/web-search-summary -g -y

Use without installing

npx skills use rcarmo/piclaw@web-search-summary

指定 Agent (Claude Code)

npx skills add rcarmo/piclaw --skill web-search-summary -a claude-code -g -y

安装 repo 全部 skill

npx skills add rcarmo/piclaw --all -g -y

预览 repo 内 skill

npx skills add rcarmo/piclaw --list

SKILL.md

Frontmatter

{
    "name": "web-search-summary",
    "description": "Search via SearXNG (or DuckDuckGo fallback), fetch top results, and return sentence-level summaries plus optional converted page content.",
    "distribution": "public"
}

Web Search Summary

Use this when you need short summaries of the top pages, not full page content.

If you need fetched Markdown as the main artifact, use web-search.

Search engine selection

If PICLAW_SEARX_URL is set or --searx-url is passed, the script uses SearXNG.
Otherwise, it falls back to DuckDuckGo HTML search (no API key required).

Examples

Run a summarised search:

bun /workspace/.pi/skills/web-search-summary/web-search-summary.ts --query "your query"

Adjust fetch depth or summary length:

bun /workspace/.pi/skills/web-search-summary/web-search-summary.ts --query "your query" --fetch-limit 3 --max-sentences 4 --max-chars 800

Output shape

The script prints JSON like:

{
  "query": "...",
  "searxUrl": "http://.../search",
  "limit": 5,
  "fetch": true,
  "maxSentences": 3,
  "maxChars": 600,
  "results": [
    {
      "title": "...",
      "url": "https://...",
      "content": "fetched markdown or original snippet",
      "summary": "short sentence-level digest"
    }
  ]
}

summary is only added for fetched items.
content contains converted Markdown when fetch succeeds.

Failure behaviour

If the search request fails, the script exits non-zero.
If page fetch fails for an individual result, the search still succeeds and that item gets summary: "Failed to fetch: ..." while other results continue.
Set --fetch false to skip page retrieval entirely.

Options

--query / --q — required search query
--limit — number of search results to return (default 5)
--fetch — set to false to skip page fetches (default true)
--fetch-limit — how many results to fetch and convert (default 2)
--searx-url — override the SearXNG endpoint (env: PICLAW_SEARX_URL; falls back to DuckDuckGo if unset)
--timeout — fetch timeout in milliseconds (default 15000)
--max-sentences — summary sentence limit (default 3)
--max-chars — summary character limit (default 600)

Notes

Summaries are heuristic first-sentence digests and may need human refinement.
HTML conversion uses turndown + linkedom and prefers <article>, <main>, or [role='main'].