Web Search by Desearch

Search the web and get real-time SERP-style results with titles, URLs, and snippets. Use this for general web queries when you need current links and informa...

Security Scan

This skill is internally consistent: it only needs a DESEARCH_API_KEY and calls the desearch.ai web API to return SERP-style results; there are no unexpected environment accesses, installs, or risky behaviors in the included code or instructions.

Purpose & Capability

Name/description, SKILL.md, and the included CLI (scripts/desearch.py) all align: the skill takes a query, reads DESEARCH_API_KEY, and calls https://api.desearch.ai/web to fetch results. No unrelated capabilities or credentials are requested.

Instruction Scope

SKILL.md instructs setting DESEARCH_API_KEY and running the CLI. The instructions and code only reference the API key and perform network requests to desearch.ai; they do not read arbitrary files, other environment variables, or send data to third parties.

Install Mechanism

No install spec is provided (instruction-only skill with an included Python script). That is low-risk; the included script is plain Python using urllib and is not obfuscated or downloading additional code.

Credentials

Only DESEARCH_API_KEY is required and it is appropriate for a third‑party web search API. No other secrets or unrelated credentials are requested.

Persistence & Privilege

The skill does not request always:true, does not modify other skills or system settings, and uses no special persistence or elevated privileges.

Assessment

This skill appears to do what it claims: it sends your search queries and the DESEARCH_API_KEY to desearch.ai and returns JSON search results. Before installing, ensure you trust the provider (https://desearch.ai) and are comfortable sending queries to it—do not use this skill for sensitive secrets or private data. Keep your DESEARCH_API_KEY secret and monitor usage/billing on the provider console. If you need higher assurance, verify the provider's docs, review the network endpoints, and confirm the included script matches the version you expect.

Real-time web search returning structured SERP-style results with titles, links, and snippets.

Quick Start

1. Get an API key from https://console.desearch.ai
2. 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 --start to 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

• API Reference
• Desearch Console