About

Imported from sickn33/agentic-awesome-skills (skills/pi-web-search/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill pi-web-search. Copyright stays with the author (MIT).

Web Search

Name: pi-web-search
Author: sickn33

When to Use

Use when a Pi Agent task needs current web information, page fetches, PDFs, YouTube, or GitHub content.
Use when Pi should use its own web-access package instead of another agent browser tool.

The pi-web-access package is installed globally. Zero-config via Exa MCP (no API key), with fallback Exa → Perplexity → Gemini.

CRITICAL: always pass `workflow: "none"`

Every web_search call MUST include workflow: "none". This skips the interactive browser curator popup (the user does not want it opening). No exceptions — single query or batched queries, always set workflow: "none".

web_search({ queries: ["query 1", "query 2"], workflow: "none" })

Tools

web_search — search the web; returns synthesized answers with citations. Can be called many times per turn. Always pass workflow: "none".
code_search — zero-key Exa code-context. Use for library/API/code lookups instead of generic web_search.
fetch_content — fetch URL(s) → markdown; handles PDFs, YouTube, GitHub.
get_search_content — big pages (>30k chars) are truncated in responses but stored in full; call this to pull the rest on demand so they don't blow context.

fetch_content specifics

GitHub URLs are cloned, not scraped — you get real files + a local path to explore with read/bash (private repos need the gh CLI). Use this for dev work.
PDFs → auto-extracted to markdown in ~/Downloads/, readable in sections (text-only, no OCR).
YouTube/video → full raw transcripts + frame extraction. Needs a GEMINI_API_KEY (not zero-config); frame extraction also needs ffmpeg/yt-dlp.

Routing — match the user's phrasing

Always use the web_search tool. These counts are HARD MINIMUMS — count your queries before answering and do not stop short:

"web search" → at least 2 queries, varied keywords/angles, then synthesize.
"extensive web research" → at least 4 queries, totally different keywords and angles.
"deep research" → at least 8 queries, totally different keywords and angles, run across 2–3 successive batches (refine angles after each batch), to learn as much as possible about the topic.

A single batched web_search call counts each query in queries[] toward the total. If your first batch is under the minimum, fire another batch before synthesizing.

Fallback / alternative: DeepAPI web search

If the Exa → Perplexity → Gemini chain fails, or you need ranked results with URLs:

test -n "$DEEPAPI_API_KEY" || { echo "DEEPAPI_API_KEY is not set"; exit 1; }
curl -s --max-time 60 "https://deepapi.co/v1/search/web" \
  -H "Authorization: Bearer $DEEPAPI_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"query": "your search terms", "maxResults": 5, "maxCostUsd": "0.05"}'

Results are in .output (title, url, snippet per item). Query under 500 chars. Full details: deepapi skill.

Limitations

Adapted from davidondrej/skills; verify local paths, tools, credentials, and agent features before acting.
For commands, remote access, scheduling, browser automation, or file-changing workflows, get explicit user approval and confirm the target environment first.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-pi-web-search/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-pi-web-search.ocm.jsonjson

{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-pi-web-search",
  "kind": "skill",
  "name": "pi-web-search",
  "description": "Give Pi Agents a safe web-search and fetch workflow using the installed pi-web-access package.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "web-search",
      "pi-agent",
      "research",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Give Pi Agents a safe web-search and fetch workflow using the installed pi-web-access package."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/pi-web-search/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/pi-web-search/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/pi-web-search/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Web Search\n\n## When to Use\n\n- Use when a Pi Agent task needs current web information, page fetches, PDFs, YouTube, or GitHub content.\n- Use when Pi should use its own web-access package instead of another agent browser tool.\n\nThe `pi-web-access` package is installed globally. Zero-config via Exa MCP (no API key), with fallback Exa → Perplexity → Gemini.\n\n## CRITICAL: always pass `workflow: \"none\"`\n\nEvery `web_search` call MUST include `workflow: \"none\"`. This skips the interactive browser curator popup (the user does not want it opening). No exceptions — single query or batched `queries`, al",
  "cost": {
    "context_tokens": 814
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-pi-web-search/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.