About desearch-web-search
desearch-web-search is a skill for searching the live web through the Desearch API. It returns structured results with titles, links, and snippets, and supports paginated retrieval.
Key features
- 01Search the live web
- 02Return titles, links, and snippets
- 03Paginate with --start
- 04Authenticate with DESEARCH_API_KEY
Use cases
- 01Search a topic and review result snippets
- 02Retrieve later results through pagination
- 03Use structured web results in research
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ desearch-ai/ desearch-openclaw-skills --skill desearch-web-searchAfter installing, type/desearch-web-searchin Claude Code to confirm it loaded.
Bundled filesscripts/desearch.py
Details
From the project READMEWeb Search By Desearch
Real-time web search returning structured SERP-style results with titles, links, and snippets.
Quick Start
- Get an API key from https://console.desearch.ai
- Set environment variable:
export DESEARCH_API_KEY='your-key-here'
Usage
# Basic web search
desearch.py web "quantum computing"
# Paginated results
desearch.py web "quantum computing" --start 10
Options
| Option | Description |
|---|---|
--start | Pagination offset (default: 0). Use to get the next page of results. |
Response
Example
desearch.py web "best sights in Georgia"
{
"data": [
{
"title": "Cool places and fun things to do in Georgia ? : r/solotravel",
"snippet": "I was in Georgia earlier this month. My favorite place was Mtirala National Park in Adjara. The mountains and forest were absolutely beautiful ...",
"link": "https://www.reddit.com/r/solotravel/comments/py4wls/cool_places_and_fun_things_to_do_in_georgia/",
},
]
}
Notes
- Returns up to 10 results per page. Use
--startto paginate.
Errors
Status 401, Unauthorized (e.g., missing/invalid API key)
{
"detail": "Invalid or missing API key"
}
Status 402, Payment Required (e.g., balance depleted)
{
"detail": "Insufficient balance, please add funds to your account to continue using the service."
}
Resources
Comments
Markdown supported