querit-search – OpenClaw Skill

---

name: querit-search description: >- Web search via Querit.ai API. Use when you need to search the web for documentation, current events, facts, or any web content. Returns structured results with titles, URLs, and snippets. metadata: {"openclaw":{"emoji":"🔎","requires":{"env":["QUERIT_API_KEY"]},"primaryEnv":"QUERIT_API_KEY","install":[{"id":"node","kind":"node","label":"Install npm dependencies"}]}}

Querit Search

Web search and content extraction via the Querit.ai API. No browser required.

Setup

Needs env: QUERIT_API_KEY — get a free key at https://querit.ai (1,000 queries/month).

Search

node {baseDir}/search.js "query"                          # 5 results (default)
node {baseDir}/search.js "query" -n 10                    # more results (max 100)
node {baseDir}/search.js "query" --lang english            # language filter
node {baseDir}/search.js "query" --country "united states" # country filter
node {baseDir}/search.js "query" --date w1                 # past week (d1/w1/m1/y1)
node {baseDir}/search.js "query" --site-include github.com # only this domain
node {baseDir}/search.js "query" --site-exclude reddit.com # exclude domain
node {baseDir}/search.js "query" --content                 # also extract page content
node {baseDir}/search.js "query" --json                    # raw JSON output

Flags can be combined:

node {baseDir}/search.js "react hooks" -n 3 --lang english --site-include reactjs.org --content

Extract Page Content

node {baseDir}/content.js https://example.com/article

Fetches a URL and extracts the main readable content as markdown.

Output Format

Search results (default)

1. Page Title
   https://example.com/page
   Site: example.com
   Age: 3 days ago
   Description snippet from search results

2. Another Page
   ...

With --content

After the result listing, each page's extracted markdown content is appended:

### 1. Page Title
URL: https://example.com/page

# Extracted heading
Extracted body content in markdown...

---

With --json

Raw JSON array of result objects with fields: url, title, snippet, page_age, page_time.

When to Use

• Searching for documentation, API references, or tutorials
• Looking up facts, current events, or recent information
• Finding content from specific websites (use --site-include)
• Fetching and reading a web page's content (use --content or content.js)
• Any task requiring web search without interactive browsing

Limitations

• Query limited to 72 characters (auto-truncated with warning)
• Max 100 results per query
• Max 20 domains per site filter
• Free tier: 1,000 queries/month, 1 QPS
• Supported languages: english, japanese, korean, german, french, spanish, portuguese

Querit Search

Web search skill for OpenClaw powered by Querit.ai.

Search the web, get structured results, and extract page content as markdown — all from your OpenClaw agent.

Quick Start

1. Install the skill (pick one method below)
2. Set your API key: export QUERIT_API_KEY="your-key-here"
3. Use it: Ask OpenClaw to "search the web for..." and it handles the rest

Installation

One-line installer

curl -fsSL https://raw.githubusercontent.com/interskh/querit-search/main/install.sh | bash

Manual (git clone)

git clone https://github.com/interskh/querit-search.git ~/.openclaw/skills/querit-search
cd ~/.openclaw/skills/querit-search && npm ci

Manual (copy)

Copy the skill files to ~/.openclaw/skills/querit-search/ and run npm ci in that directory.

Configuration

Get a free API key at querit.ai (1,000 queries/month, no credit card required).

Option A: Environment variable

export QUERIT_API_KEY="your-key-here"

Add to your ~/.bashrc, ~/.zshrc, or ~/.profile to persist.

Option B: OpenClaw config

In ~/.openclaw/openclaw.json:

{
  "skills": {
    "entries": {
      "querit-search": {
        "apiKey": "your-key-here"
      }
    }
  }
}

Option C: .env file

Create ~/.openclaw/.env:

QUERIT_API_KEY=your-key-here

Usage Examples

Just ask OpenClaw naturally:

• "Search for React server components best practices"
• "Find the latest Node.js release notes"
• "Look up how to use CSS container queries"
• "Search for TypeScript 5.4 new features and read the first result"

OpenClaw will use the skill automatically when it needs to search the web.

CLI Reference

search.js

search.js <query> [options]

Options:
  -n <count>                Number of results (default: 5, max: 100)
  --lang <language>         Language filter
  --country <country>       Country filter
  --date <range>            Date filter: d1 (day), w1 (week), m1 (month), y1 (year)
  --site-include <domain>   Only include results from this domain (repeatable)
  --site-exclude <domain>   Exclude results from this domain (repeatable)
  --content                 Also fetch and extract page content as markdown
  --json                    Output raw JSON

Supported languages: english, japanese, korean, german, french, spanish, portuguese

Supported countries: argentina, australia, brazil, canada, colombia, france, germany, india, indonesia, japan, mexico, nigeria, philippines, south korea, spain, united kingdom, united states

content.js

content.js <url>

Fetches a URL and extracts the main readable content as markdown using Readability + Turndown.

API Limits

Plan	Price	Queries	Rate limit
Free	$0	1,000/month	1 QPS
Pro	$4/1,000 requests	Unlimited	10 QPS
Enterprise	$6/1,000 requests	Unlimited	Unlimited

Additional constraints:

• Query: max 72 characters (auto-truncated with warning)
• Results: max 100 per query
• Site filters: max 20 domains each

Troubleshooting

"QUERIT_API_KEY environment variable is not set"

Make sure your API key is exported in the shell where OpenClaw runs. If using OpenClaw config, check the path is skills.entries.querit-search.apiKey.

"npm ci failed" during install

Try npm install instead. Make sure you have Node.js 18+ (node -v).

"API returned error 401"

Your API key is invalid or expired. Generate a new one at querit.ai.

"API returned error 429"

Rate limit exceeded. Free tier allows 1 query per second and 1,000 queries per month.

"Could not extract readable content from page"

Some pages (SPAs, paywalled content, PDFs) can't be extracted by Readability. This is expected — the search results themselves are still useful.

Contributing

1. Clone the repo
2. Make changes
3. Test locally:

   ./search.js "test query"
   ./search.js "test" --json
   ./content.js https://example.com
   

4. Submit a PR

License

MIT