Tutorial

How to Build a Research Workflow in Claude Code

Set up a Claude Code research workflow using Scavio MCP: search Google, Reddit, and YouTube from your terminal, synthesize findings into docs.

Claude Code with MCP search transforms your terminal into a research workstation. Instead of switching between browser tabs, search multiple platforms directly from Claude Code and have findings synthesized into structured documents. This tutorial sets up the workflow.

Prerequisites

  • Claude Code installed
  • A Scavio API key

Walkthrough

Step 1: Configure Scavio MCP in your project

Add Scavio MCP to your project's .mcp.json for research capabilities.

JSON
// Create or edit .mcp.json in your project root:
{
  "mcpServers": {
    "scavio": {
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "your_scavio_api_key"
      }
    }
  }
}

Step 2: Use search tools in Claude Code

Once configured, ask Claude Code to research topics using the available search tools.

Bash
# In Claude Code, you can now say:
# 'Research the current state of SERP API pricing in 2026.
#  Search Google for official pricing pages and Reddit for developer opinions.'

# Claude Code will:
# 1. Use google_search tool for pricing data
# 2. Use reddit_search tool for community opinions
# 3. Synthesize into a research document

# Other useful research patterns:
# 'Search YouTube for tutorials on FastAPI deployment and summarize the top approaches'
# 'Search Reddit for complaints about Brave Search API and identify common issues'
# 'Search Google for the latest on the SerpAPI lawsuit, check Reddit for analysis'

Step 3: Create a CLAUDE.md research prompt

Add a research instruction to your CLAUDE.md so Claude Code knows your research preferences.

# Add to your project's CLAUDE.md:

## Research Workflow
- When researching a topic, always search at least 2 platforms (Google + Reddit minimum)
- Format research findings as Markdown documents in the /research folder
- Include source URLs for every claim
- For technical topics, also search YouTube for tutorial content
- Use structured format: Summary > Sources > Key Findings > Open Questions

Step 4: Example research session

Walk through a complete research session in Claude Code.

Bash
# Example interaction in Claude Code:

# You: 'Research alternatives to Brave Search API for our project.
#       We need something with a free tier, MCP support, and multi-platform search.'

# Claude Code will:
# 1. google_search('brave search api alternatives 2026 free tier')
# 2. reddit_search('brave search api alternative mcp')
# 3. google_search('search api mcp server comparison')
# 4. Create a document like research/brave-alternatives.md with findings

# Output: A structured document with:
# - Summary of options (Scavio, Serper, Tavily, etc.)
# - Pricing comparison table
# - Community opinions from Reddit
# - Recommendation based on your requirements

Python Example

Python
# No Python needed - MCP handles integration directly in Claude Code.
# Configure .mcp.json and ask Claude Code to research topics.
# Results come from: google_search, reddit_search, youtube_search,
# amazon_search, walmart_search tools.

JavaScript Example

JavaScript
// .mcp.json configuration:
{
  "mcpServers": {
    "scavio": {
      "url": "https://mcp.scavio.dev/mcp",
      "headers": { "x-api-key": "your_key" }
    }
  }
}

Expected Output

JSON
A Claude Code setup with Scavio MCP that enables multi-platform research directly from your terminal, synthesizing findings into structured documents.

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.

Claude Code installed. A 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

Set up a Claude Code research workflow using Scavio MCP: search Google, Reddit, and YouTube from your terminal, synthesize findings into docs.