ry0narushima / bettersearch

# BetterSearch
DeepSeek just opened up the search engine behind its app. Any agent can call it now for **$0.75 per 1,000 searches**.
Raw results are decent. But an agent sending one vague query gets one vague answer... and sometimes some of it in Chinese (we searched in English and 2 of the top 5 came back in Chinese).
BetterSearch is a skill that fixes the part around the API: better queries, parallel research, a fact-check pass, and a clean report at the end. It works in Claude Code, Codex, Cursor, Gemini CLI, OpenCode and Hermes.
## Install
 [code] 
Then add your DeepSeek key, once:
 [code] 
It opens the key page, tells you what to click, tests the key and saves it to `~/.config/deepseek-research/` (chmod 600). The key never goes through your agent's chat. `DEEPSEEK_API_KEY` works too.
## Two modes
**Quick** is the default. Ask a normal question, get a sourced answer in chat.
 [code] 
**Advanced** kicks in when you say "deep research", or the question is big.
 [code] 
No subagent tool in your agent? It runs the same roles one after another. Same output.
## The report
One self-contained HTML file. No CDN, no JS dependencies, works offline, dark mode included. Every claim is tagged **verified**, **single source** or **conflicting**, and every citation links to its source card.
## What it costs
| | per 1,000 calls |
|---|---|
| DeepSeek Search | $0.75 |
| DeepSeek Fetch | $0.75 |
| Brave Search | $5 |
| Exa Search | from $4 |
A quick question is usually 3 to 6 calls. A deep report is around 40 to 60, so roughly **$0.04**.
Note: search calls made by Claude Code or Codex through DeepSeek's own server-side tools are free until Oct 31, 2026. BetterSearch calls the API directly, so those are billed normally.
## Use the CLI directly
 [code] 
Python 3.9+, standard library only. Throttled under DeepSeek's 5 QPS limit, retries 429s with backoff.
## Files
 [code] 
## Credits
Built on DeepSeek's Search & Fetch API. Not affiliated with DeepSeek. Report fonts: Poppins and Lora (SIL Open Font License). MIT license.