🔍 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 — 3,000 searches/month, no credit card needed. Get your key at prismfy.io.

Setup

1. Install the skill

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)

# 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 search.sh --quota

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

That's it. No credit card, no waitlist. 3,000 free searches every month.

How to use

/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

Engine	What it's good for	Free
`brave`	General web search, privacy-first	✅
`bing`	News, broad coverage	paid
`google`	Most comprehensive web search	paid
`reddit`	Real user opinions, discussions	paid
`github`	Code, repos, issues, READMEs	paid
`arxiv`	Academic papers, research	paid
`hackernews`	Tech community, startups	paid
`askubuntu`	Linux, Ubuntu, shell questions	paid
`yahoonews`	Latest news headlines	paid

Default (no

--engine

): uses

brave

yahoo

in parallel — both free.

Options

Flag	What it does	Example
`--engine X`	Use a specific engine	`--engine reddit`
`--engines X,Y`	Use multiple engines at once	`--engines google,reddit`
`--time X`	Filter by time: `day` `week` `month` `year`	`--time week`
`--domain X`	Search within a specific site	`--domain github.com`
`--page N`	Go to results page N	`--page 2`
`--quota`	Check 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:

# 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

/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

→ Google, Reddit, GitHub etc. require a paid plan. Free tier supports

brave

startpage

, and

yahoo

. Use one of those or upgrade at prismfy.io.

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

Implementation

When this skill is invoked, follow these steps:

Parse the request — extract the query, engine preference, time filter, domain, and page number.
Run
```
search.sh
```
with the parsed arguments:

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

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
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
For
```
--quota
```
flag:

bash search.sh --quota

Powered by Prismfy — web search infrastructure for developers.

Prismfy Web Search

AI Skill Market Insights

Be Part of the 0+ Developer Community