Agent skill

9Router Web Search

by decolua in decolua/9router

Runs web, news and public X searches through a 9Router gateway's search endpoint, choosing among providers such as Tavily, Exa, Brave and Perplexity.

MITAuto-check passedProductivity & Automation

Install 9Router Web Search

skills CLI
$ npx skills add decolua/9router --skill 9router-web-search -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install decolua/9router 9router-web-search --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/decolua/9router.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/9router-web-search .claude/skills/9router-web-search && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
9router-web-search
GitHub stars
31k
Token cost
~1k tokens
SKILL.md length
186 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Runs web, news and public X searches through a 9Router gateway's search endpoint, choosing among providers such as Tavily, Exa, Brave and Perplexity.

  • Searching the web or recent news through a 9Router gateway
  • SKILL.md covers Discover, Endpoint, Examples and Response shape, plus 1 more section
  • Calls curl and jq; needs NINEROUTER_KEY
  • Looking up public X posts with Xquik

What it does

The agent calls a 9Router instance given by `NINEROUTER_URL`, with `NINEROUTER_KEY` when auth is on. It lists search providers from `/v1/models/web`, checks a provider's parameters at `/v1/models/info`, then sends a POST to `/v1/search` with a model or provider and a query. Optional fields include `max_results` (default 5), `search_type` (web, news, or x for Xquik) and provider-dependent country, language, time range and domain filter.

Provider IDs end in `/search`, and combos chain several providers with automatic fallback. The description names Tavily, Exa, Brave, Serper, SearXNG, Google PSE, Linkup, SearchAPI, You.com, Perplexity and Xquik, and a table shows which options each supports. X search through Xquik needs its API key added in 9Router's provider settings, costs 1 credit per returned post and continues with a pagination cursor. Examples are given as curl and JavaScript.

When your agent uses it

  • Searching the web or recent news through a 9Router gateway
  • Looking up public X posts with Xquik
  • Comparing provider-specific search options before choosing one

Example prompts

  • “Search the web for recent articles about SQLite WAL mode and give me five links.”
  • “Find public X posts about the latest Next.js release using Xquik.”
  • “List which search providers my 9Router instance exposes.”

Requirements

  • A 9Router instance, with `NINEROUTER_URL` set and `NINEROUTER_KEY` if auth is enabled
  • Provider keys configured in 9Router, for example for Xquik

What it can do on your machine

Read from SKILL.md and the folder at commit ce4460e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NINEROUTER_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

9Router Web Search loads about 1k tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 186 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from decolua/9router at commit ce4460e, republished under its MIT licence (© decolua). 186 words, ~1,035 tokens.

Download SKILL.mdSave it as .claude/skills/9router-web-search/SKILL.md (or your agent's skills folder).
name
9router-web-search
description
Web and X search via 9Router /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Linkup / SearchAPI / You.com / Perplexity / Xquik. Use when the user wants to search the web, find articles, or search public X posts.

Requires NINEROUTER_URL (and NINEROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router/SKILL.md for setup.

Discover

bash
curl $NINEROUTER_URL/v1/models/web | jq '.data[] | select(.kind=="webSearch") | .id'
# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)
curl "$NINEROUTER_URL/v1/models/info?id=tavily/search"

IDs end in /search (e.g. tavily/search). Combos (owned_by:"combo") chain providers with auto-fallback.

Endpoint

POST $NINEROUTER_URL/v1/search

FieldRequiredNotes
model (or provider)yesfrom /v1/models/web (e.g. tavily or brave)
queryyessearch query
max_resultsnodefault 5
search_typenoweb (default) / news / x for Xquik
country, language, time_range, domain_filternoprovider-dependent

Examples

bash
curl -X POST $NINEROUTER_URL/v1/search \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"tavily","query":"9Router open source","max_results":5}'

JS:

js
const r = await fetch(`${process.env.NINEROUTER_URL}/v1/search`, {
  method: "POST",
  headers: { "Authorization": `Bearer ${process.env.NINEROUTER_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ model: "search-combo", query: "latest LLM benchmarks", max_results: 10 }),
});
console.log(await r.json());

X search with Xquik:

bash
curl -X POST $NINEROUTER_URL/v1/search \
  -H "Authorization: Bearer $NINEROUTER_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"xquik","query":"from:github release","max_results":10,"provider_options":{"queryType":"Latest"}}'

Add the Xquik API key in 9Router's provider settings. Xquik charges 1 credit per returned post. Continue a search by passing pagination.next_cursor as provider_options.cursor.

Xquik responses include provider pagination and credit usage:

json
{
  "pagination": { "has_more": true, "next_cursor": "cursor-2" },
  "usage": { "queries_used": 1, "search_cost_usd": null, "provider_credits_used": 10 }
}

Response shape

json
{
  "provider": "tavily",
  "query": "9Router open source",
  "results": [
    {
      "title": "...", "url": "https://...", "display_url": "github.com/...",
      "snippet": "...", "position": 1, "score": 0.92,
      "published_at": null, "favicon_url": null, "content": null,
      "metadata": { "author": null, "language": null, "source_type": null, "image_url": null },
      "citation": { "provider": "tavily", "retrieved_at": "2026-...", "rank": 1 }
    }
  ],
  "answer": null,
  "usage": { "queries_used": 1, "search_cost_usd": 0.008 },
  "metrics": { "response_time_ms": 850, "upstream_latency_ms": 700, "total_results_available": 12 },
  "errors": []
}

Provider quirks

All accept query + max_results. Optional fields vary:

ProviderSupportsRequired extras
tavilycountry, domain_filter, news topic—
exadomain_filter (incl/excl), news category—
brave-searchcountry, language—
serpercountry, language, news endpoint—
perplexitycountry, language, domain_filter—
linkupdomain_filter, time_rangedepth: fast/standard/deep (option)
google-psecountry, language, time_range, offsetcx required (providerOptions)
searchapicountry, language, pagination—
youcomcountry, language, time_range, domain_filter, full_page—
searxnglanguage, time_rangeSelf-hosted, noAuth
xquikX/Twitter search operators, language, cursor paginationqueryType: Latest/Top, cursor (options)

Provider IS the model — "provider":"tavily" ≡ "model":"tavily".

© decolua, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/9router-web-search of decolua/9router.

Open the folder on GitHubat commit ce4460e

Compare with similar skills

9Router Web Search next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

9Router Web Search compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
9Router Web Search this skilldecolua/9router31k—~1kAutomated safety check: PassMIT
Web SearchEXboys/skilllite1702 repos~1kAutomated safety check: PassMIT
Web Searchtmustier/pi-for-excel434—~410Automated safety check: PassMIT
Brave Local Place Descriptionsbrave/brave-search-skills183—~1kAutomated safety check: PassMIT
Brave Local Place Searchbrave/brave-search-skills183—~3.4kAutomated safety check: PassMIT
Keirouter Web Searchmydisha/keirouter147—~771Automated safety check: PassMIT

Similar skills

  • Web Search

    EXboys/skilllite

    Web search and content extraction with Tavily and Exa via inference.sh CLI.

    170 GitHub starsUsed in 2 repos~1k tokens
    Productivity & AutomationAuto-check passed
  • Web Search

    tmustier/pi-for-excel

    Search the public web for up-to-date facts. An agent skill from tmustier/pi-for-excel.

    434 GitHub stars~410 tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Brave Local Place Descriptions

    brave/brave-search-skills

    Fetches AI-written text descriptions for local places from the Brave Search API, using place IDs returned by an earlier local search.

    183 GitHub stars~1k tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed
  • Brave Local Place Search

    brave/brave-search-skills

    Looks up businesses, points of interest, addresses and streets through the Brave Search place endpoint, returning contact details, ratings and hours in one call.

    183 GitHub stars~3.4k tokensUpdated 17 days ago
    Productivity & AutomationAuto-check passed
  • Keirouter Web Search

    mydisha/keirouter

    Web search via KeiRouter /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Perplexity.

    147 GitHub stars~771 tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Search Layer

    aAAaqwq/AGI-Super-Team

    四源同级:Brave (websearch) + Exa + Tavily + Grok。按意图自动选策略、调权重、做合成。

    105 GitHub starsUsed in 1 repo~1.9k tokens
    Productivity & AutomationAuto-check passed

More from decolua/9router

All 9 skills in this repo
  • Sets up access to the 9Router AI gateway, an OpenAI-compatible REST endpoint for chat, images, speech, embeddings, web search and web fetch, and indexes its capability skills.

    31k GitHub stars~744 tokensUpdated 2 days ago
    Auto-check passed
  • Sends chat and code-generation requests through a 9Router gateway using OpenAI or Anthropic message formats, with streaming and auto-fallback combos.

    31k GitHub stars~635 tokensUpdated 2 days ago
    Auto-check passed
  • Embeddings via 9Router

    decolua/9router

    Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

    31k GitHub stars~604 tokensUpdated 2 days ago
    Auto-check passed
  • Generates images through a 9Router gateway's image endpoint, with model discovery, the request fields and per-provider quirks for OpenAI, Gemini, MiniMax and others.

    31k GitHub stars~830 tokensUpdated 2 days ago
    Auto-check passed
  • 9Router Speech-to-Text

    decolua/9router

    Transcribes audio files into text or subtitles through 9Router's Whisper-compatible endpoint, using models from OpenAI, Groq, Gemini, Deepgram and others.

    31k GitHub stars~914 tokensUpdated 2 days ago
    Auto-check passed
  • 9Router Text to Speech

    decolua/9router

    Turns text into spoken audio through a 9Router server, choosing among voices from OpenAI, ElevenLabs, Deepgram, Edge TTS and other providers.

    31k GitHub stars~765 tokensUpdated 2 days ago
    Auto-check passed

Questions about 9Router Web Search

What does 9Router Web Search do?

Runs web, news and public X searches through a 9Router gateway's search endpoint, choosing among providers such as Tavily, Exa, Brave and Perplexity. The agent calls a 9Router instance given by `NINEROUTER_URL`, with `NINEROUTER_KEY` when auth is on. It lists search providers from `/v1/models/web`, checks a provider's parameters at `/v1/models/info`, then sends a POST to `/v1/search` with a model or provider and a query.

When should I use 9Router Web Search?

9Router Web Search fits situations like: searching the web or recent news through a 9Router gateway; looking up public X posts with Xquik; comparing provider-specific search options before choosing one.

How do I install 9Router Web Search in Claude Code?

Run `npx skills add decolua/9router --skill 9router-web-search -a claude-code`. Or copy the skill folder (skills/9router-web-search in decolua/9router) into .claude/skills/9router-web-search in your project. Claude Code loads it when a task matches its description.

How do I install 9Router Web Search in Codex?

Run `npx skills add decolua/9router --skill 9router-web-search -a codex`. Or copy the skill folder (skills/9router-web-search in decolua/9router) into .agents/skills/9router-web-search in your project. Codex loads it when a task matches its description.

Can I use 9Router Web Search in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add decolua/9router --skill 9router-web-search -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/9router-web-search, .gemini/skills/9router-web-search, .github/skills/9router-web-search and .opencode/skills/9router-web-search in your project.

What does 9Router Web Search need to run?

Going by SKILL.md and its folder, 9Router Web Search needs the command-line tools its instructions call (curl and jq) and credentials named NINEROUTER_KEY. Our summary lists: A 9Router instance, with `NINEROUTER_URL` set and `NINEROUTER_KEY` if auth is enabled; Provider keys configured in 9Router, for example for Xquik.

Does 9Router Web Search access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is 9Router Web Search safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does 9Router Web Search use?

9Router Web Search is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does 9Router Web Search use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to 9Router Web Search?

Skills that share tags, products or a category with 9Router Web Search: Web Search (EXboys/skilllite, 170 stars), Web Search (tmustier/pi-for-excel, 434 stars), Brave Local Place Descriptions (brave/brave-search-skills, 183 stars) and Brave Local Place Search (brave/brave-search-skills, 183 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains 9Router Web Search?

decolua (a GitHub user) maintains it in decolua/9router, which has 30,536 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on October 8, 2026.

Source: decolua/9router on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.