---
id: sm-research
name: "research"
url: https://skills.yangsir.net/skill/sm-research
author: tavily-ai
domain: data-ai
tags: ["Data Research", "Information Retrieval", "Web Scraping", "Data Analysis", "Academic Research"]
install_count: 6570
rating: 4.50 (263 reviews)
github: https://github.com/tavily-ai/skills
---

# research

> 此技能用于进行综合性研究，自动收集、分析来源并生成带引用的响应，帮助用户深入探索任何主题。

**Stats**: 6,570 installs · 4.5/5 (263 reviews)

## Before / After 对比

### 综合性研究自动化，深度探索任何主题

## Readme

# research

# Research Skill

Conduct comprehensive research on any topic with automatic source gathering, analysis, and response generation with citations.

## Authentication

The script uses OAuth via the Tavily MCP server. **No manual setup required** - on first run, it will:

- Check for existing tokens in `~/.mcp-auth/`

- If none found, automatically open your browser for OAuth authentication

**Note:** You must have an existing Tavily account. The OAuth flow only supports login — account creation is not available through this flow. [Sign up at tavily.com](https://tavily.com) first if you don't have an account.

### Alternative: API Key

If you prefer using an API key, get one at [https://tavily.com](https://tavily.com) and add to `~/.claude/settings.json`:

```
{
  "env": {
    "TAVILY_API_KEY": "tvly-your-api-key-here"
  }
}

```

## Quick Start

**Tip**: Research can take 30-120 seconds. Press **Ctrl+B** to run in the background.

### Using the Script

```
./scripts/research.sh '<json>' [output_file]

```

**Examples:**

```
# Basic research
./scripts/research.sh '{"input": "quantum computing trends"}'

# With pro model for comprehensive analysis
./scripts/research.sh '{"input": "AI agents comparison", "model": "pro"}'

# Save to file
./scripts/research.sh '{"input": "market analysis for EVs", "model": "pro"}' ./ev-report.md

# Quick targeted research
./scripts/research.sh '{"input": "climate change impacts", "model": "mini"}'

```

## Parameters

Field
Type
Default
Description

`input`
string
Required
Research topic or question

`model`
string
`"mini"`
Model: `mini`, `pro`, `auto`

## Model Selection

**Rule of thumb**: "what does X do?" -> mini. "X vs Y vs Z" or "best way to..." -> pro.

Model
Use Case
Speed

`mini`
Single topic, targeted research
~30s

`pro`
Comprehensive multi-angle analysis
~60-120s

`auto`
API chooses based on complexity
Varies

## Examples

### Quick Overview

```
./scripts/research.sh '{"input": "What is retrieval augmented generation?", "model": "mini"}'

```

### Technical Comparison

```
./scripts/research.sh '{"input": "LangGraph vs CrewAI for multi-agent systems", "model": "pro"}'

```

### Market Research

```
./scripts/research.sh '{"input": "Fintech startup landscape 2025", "model": "pro"}' fintech-report.md

```
Weekly Installs6.5KRepository[tavily-ai/skills](https://github.com/tavily-ai/skills)GitHub Stars95First SeenJan 25, 2026Security Audits[Gen Agent Trust HubWarn](/tavily-ai/skills/research/security/agent-trust-hub)[SocketPass](/tavily-ai/skills/research/security/socket)[SnykWarn](/tavily-ai/skills/research/security/snyk)Installed onopencode5.9Kgemini-cli5.8Kcodex5.8Kgithub-copilot5.6Kkimi-cli5.5Kamp5.5K

---
*Source: https://skills.yangsir.net/skill/sm-research*
*Markdown mirror: https://skills.yangsir.net/api/skill/sm-research/markdown*