🔍 Prismfy Web Search

Default web search for OpenClaw. Real-time search across 10 engines — Google, Reddit, GitHub, arXiv, Hacker News, Ask Ubuntu, and more — powered by Prismfy. No proxy hassle, no CAPTCHA, no blocked requests. Just results.

Free tier available — no credit card needed. Free tier includes Google (with limits). Get your key at prismfy.io.

---

Setup

1. Install the skill

bash

openclaw skills install prismfy-search

---

2. Get an API key

Head to prismfy.io, create a free account, and grab your API key from Dashboard → API Keys. No credit card required.

---

3. Add the key to your environment

Option A — Shell profile (permanent)

bash

# Add to ~/.zshrc or ~/.bashrc:
export PRISMFY_API_KEY="ss_live_your_key_here"

# Then reload:
source ~/.zshrc   # or: source ~/.bashrc

Option B — OpenClaw env config

Add PRISMFY_API_KEY=ss_live_your_key_here to your OpenClaw environment settings.

---

4. Verify it works

bash

bash search.sh --quota

You should see your plan, searches used, and how many you have left.

---

That's it. No credit card, no waitlist.

---

How to use

text

/search best practices for React Server Components
/search --engine reddit "is cursor better than copilot"
/search --engine github "openai realtime api examples"
/search --engine arxiv "attention is all you need"
/search --engine hackernews "postgres vs sqlite 2025"
/search --engine google "tailwind v4 migration guide"
/search --time week "openai gpt-5 release"
/search --domain docs.python.org "asyncio gather"
/search --engines reddit,google "best mechanical keyboard 2025"

Or just talk naturally:

• "Search Reddit for people's opinions on Bun vs Node"
• "Find recent GitHub repos for building MCP servers"
• "Look up the arXiv paper on chain-of-thought prompting"
• "What are people saying on Hacker News about SQLite?"

---

Available engines

EngineWhat it's good forFreebraveGeneral web search, privacy-first✅bingNews, broad coveragepaidgoogleMost comprehensive web search✅ (with limits)redditReal user opinions, discussionspaidgithubCode, repos, issues, READMEspaidarxivAcademic papers, researchpaidhackernewsTech community, startupspaidaskubuntuLinux, Ubuntu, shell questionspaidyahoonewsLatest news headlinespaid

Default (no --engine): uses brave + yahoo in parallel — both free.

---

Options

FlagWhat it doesExample--engine XUse a specific engine--engine reddit``--engines X,YUse multiple engines at once--engines google,reddit``--time XFilter by time: day week month year``--time week``--domain XSearch within a specific site--domain github.com``--page NGo to results page N--page 2``--quotaCheck your remaining free quota--quota

---

How the skill works

The skill uses search.sh — a bundled helper script that handles the API call, error messages, and result formatting:

bash

# Simple search (free)
bash search.sh "typescript best practices 2025"

# With engine
bash search.sh --engine reddit "is bun worth switching from node"

# Multiple engines
bash search.sh --engines google,reddit "nextjs vs remix"

# With time filter
bash search.sh --time week "openai new model"

# Raw JSON output
bash search.sh --raw "rust async runtime"

Results come back with title, URL, snippet, and which engine found it. Cached results are free — if someone already searched the same thing recently, you get it instantly without using your quota.

---

Check your quota

text

/search --quota

Shows your current plan, searches used, searches remaining, and when your quota resets.

---

Troubleshooting

PRISMFY_API_KEY is not set → Add export PRISMFY_API_KEY="ss_live_..." to your shell profile and restart the terminal.

401 Unauthorized → Double-check your key starts with ss_live_. Keys are shown only once — if lost, create a new one in Dashboard → API Keys.

Engine not available on your plan → Free tier includes Google with limits. Check current plan limits with bash search.sh --quota or choose another engine.

No results / empty results → Try a different engine or rephrase your query.

---

Implementation

When this skill is invoked, follow these steps:

1. Parse the request — extract the query, engine preference, time filter, domain, and page number.

2. Run search.sh with the parsed arguments:

bash

bash search.sh [--engine X] [--engines X,Y] [--time X] [--domain X] [--page N] <query>

1. Handle the output:
   • ⚡ Cached result line → mention it was free (no quota used)
   • Empty results → suggest rephrasing or a different engine
   • ❌ Invalid API key → guide user to check PRISMFY_API_KEY
   • ❌ Engine not available → tell user to check their plan at prismfy.io
2. Present results in a clear, useful format:
   • Answer the underlying question using the content
   • List sources with titles and URLs
   • For Reddit/HN results: summarize the discussion sentiment
   • For GitHub results: highlight repo name and what it does
   • For arXiv results: summarize the abstract
3. For --quota flag:

bash

bash search.sh --quota

---

Powered by Prismfy — web search infrastructure for developers.