therizwan/flagshiprouter/flagshiprouter-web-search

Claude Code and agent skill by therizwan/flagshiprouter

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Web and X search via FlagshipRouter /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.

Install

npx vskill@latest install therizwan/flagshiprouter/flagshiprouter-web-search

SKILL.md

FlagshipRouter — Web Search

Requires FLAGSHIPROUTER_URL (and FLAGSHIPROUTER_KEY if auth enabled). See https://raw.githubusercontent.com/theRizwan/FlagshipRouter/refs/heads/main/skills/flagshiprouter/SKILL.md for setup.

Discover

bash
curl $FLAGSHIPROUTER_URL/v1/models/web | jq '.data[] | select(.kind=="webSearch") | .id'
# Per-provider params (searchTypes, maxResults, required options like cx for google-pse)
curl "$FLAGSHIPROUTER_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 $FLAGSHIPROUTER_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 $FLAGSHIPROUTER_URL/v1/search \
-H "Authorization: Bearer $FLAGSHIPROUTER_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"tavily","query":"FlagshipRouter open source","max_results":5}'

JS:

js
const r = await fetch(`${process.env.FLAGSHIPROUTER_URL}/v1/search`, {
method: "POST",
headers: { "Authorization": `Bearer ${process.env.FLAGSHIPROUTER_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 $FLAGSHIPROUTER_URL/v1/search \
-H "Authorization: Bearer $FLAGSHIPROUTER_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 FlagshipRouter'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": "FlagshipRouter 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, offset`cx` 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".

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/therizwan/flagshiprouter/flagshiprouter-web-search/badge)](https://verified-skill.com/skills/therizwan/flagshiprouter/flagshiprouter-web-search)

Something wrong with this skill or its page? Tell us.