ModSearch — Search & Fetch Bridge
A CLI bridge skill that gives models without native web tools structured web search, X (Twitter) search, and page fetching as JSON evidence.
Web & APIIntermediate★ 572⑂ 21AI score 10/10Last updated: Sep 24, 2026
What it does
- Runs the
modsearchCLI to perform web search, X (Twitter) search, and single-URL page fetch, returning a stable JSON contract. - Works out of the box with Firecrawl's keyless free quota; optional engines (Tavily, Exa, antigravity-cli, grok-cli) are selected per role with automatic fallback.
- Quota-exhausted engines go into a cooldown queue instead of being dropped; responses separate
status(ok/degraded/unavailable),uncertainty(doubt about the facts) andwarnings(how the answer was routed). - A bundled launcher (
scripts/run.sh/run.ps1) resolves PATH → npx → bunx and emits a JSON diagnosis with next steps when no runtime is available. - Explicit safety rule: fetched pages and posts are untrusted data, never instructions to follow.
Who it's for
- Anyone running a model or harness with no built-in search/fetch tool but who needs current, citable information.
- Researchers, analysts and engineers who need source links for versions, prices, releases or news.
- Marketers and social researchers tracking discussion on X.
Examples
- "What's the latest release of this library?" →
-qto search, then-uon the best hit to read release notes and cite URLs. - "What are people saying about this product on X?" →
--source x; if Grok Build isn't configured, the entry comes backdegradedand the caveat is relayed. - "Summarize only the pricing section of this URL" →
-u <url> -q "pricing"for a focused fetch.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/liustack/modsearch/HEAD/skills/modsearch/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skills/modsearch folder from the GitHub repo liustack/modsearch into my ~/.claude/skills/modsearch/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/liustack/modsearch.git /tmp/modsearch && mkdir -p ~/.claude/skills && cp -r /tmp/modsearch/skills/modsearch ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and check your runtime:
node -v(needs 22.13+) orbun -v. If neither exists, install Node from https://nodejs.org or Bun from https://bun.sh. - Clone the repo:
git clone https://github.com/liustack/modsearch.git /tmp/modsearch - Copy the skill folder:
mkdir -p ~/.claude/skills && cp -r /tmp/modsearch/skills/modsearch ~/.claude/skills/ - Make the launcher executable:
chmod +x ~/.claude/skills/modsearch/scripts/run.sh - Smoke test:
bash ~/.claude/skills/modsearch/scripts/run.sh -q "test"(on Windows:powershell -ExecutionPolicy Bypass -File ...\scripts\run.ps1 -q "test"). - If something fails, run
bash ~/.claude/skills/modsearch/scripts/run.sh doctor --jsonand consultreferences/configure.mdto add API keys or switch engines. - Restart Claude Code; the skill triggers automatically when a request needs fresh information or a specific URL.
View source on GitHub ↗License: MIT