ScavioScavio
Tutorial

How to Set Up Comet Skill for Claude Code (2026)

Walk-through: install Comet Skill, attach Scavio MCP, configure routing. Free deep research delegation if Pro is paid.

Get Free API KeyAPI Docs

An r/codex post: web research inside Claude Code/Codex blocks the agent or dumps 10K tokens. Comet Skill delegates. This walks the setup.

Prerequisites

  • Perplexity Pro subscription
  • Comet desktop installed and signed in
  • Claude Code or Codex CLI
  • Scavio API key

Walkthrough

Step 1: Clone Comet Skill repo

github.com/ammarshah1n/comet-skill.

Bash
git clone https://github.com/ammarshah1n/comet-skill.git
cd comet-skill

Step 2: Install per repo README

Small Node/Python install + CDP setup.

Text
// Follow repo's install steps.

Step 3: Verify Comet desktop is running with logged-in Pro session

CDP connects to the open browser instance.

Text
// Open Comet, verify Pro account is signed in.

Step 4: Attach Scavio MCP for fast typed lookups

Pair Comet (deep research) with Scavio (fast typed search).

Bash
claude mcp add scavio https://mcp.scavio.dev/mcp --header 'x-api-key: $SCAVIO_API_KEY'

Step 5: System prompt routing rule

Explicit.

Text
// CLAUDE.md: 'For fast typed lookups call scavio.search. For deep multi-step research call comet_research; do NOT block waiting.'

Step 6: Test the flow

Trigger a deep research request.

Text
// 'Research the current state of long-horizon agent infrastructure. Use comet_research; don't block.'

Step 7: Verify agent stays unblocked

Comet returns a /search/<id> URL fast.

Text
// Watch Claude's tool log: comet_research returns within seconds.

Python Example

Python
# Cost: $0 marginal API on deep research (uses Pro). Scavio $30/mo for fast lookups.

JavaScript Example

JavaScript
// Same setup.

Expected Output

JSON
Claude Code with two clearly-named research tools: scavio.search (fast typed JSON) and comet_research (delegated, returns URL).

Related Tutorials

Frequently Asked Questions

Most developers complete this tutorial in 15 to 30 minutes. You will need a Scavio API key (free tier works) and a working Python or JavaScript environment.

Perplexity Pro subscription. Comet desktop installed and signed in. Claude Code or Codex CLI. Scavio API key. A Scavio API key gives you 500 free credits per month.

Yes. The free tier includes 500 credits per month, which is more than enough to complete this tutorial and prototype a working solution.

Scavio has a native LangChain package (langchain-scavio), an MCP server, and a plain REST API that works with any HTTP client. This tutorial uses the raw REST API, but you can adapt to your framework of choice.

Start Building

Walk-through: install Comet Skill, attach Scavio MCP, configure routing. Free deep research delegation if Pro is paid.

Get Started FreeRead the Docs