# DuckDuckGo SEO & Trend Radar MCP Server

A high-performance Model Context Protocol (MCP) server built with TypeScript, designed for YouTube content strategists, SEO researchers, and autonomous AI agents. It provides real-time search engine intelligence, emerging topic detection, long-tail keyword clustering, and clean web content extraction without requiring external API keys.

## 🚀 Key Features

1. **ddg_keyword_suggestions**
   - Fetches real-time search suggestions directly from DuckDuckGo Autocomplete.
   - Automatically clusters queries into search intents:
     - **Questions:** Informational queries (* cómo*, *por qué*, *qué es*).
     - **Comparisons:** Decision-making keywords (*vs*, *diferencias*).
     - **Commercial & Tutorials:** Practical and transactional queries (*tutorial*, *curso*, *guía*).
     - **Long-tail:** High-specificity niche queries.

2. **ddg_trend_radar**
   - Discovers emerging news and trending topics across customizable time windows (24 hours, 7 days, 14 days, 30 days).
   - Powered by resilient Google News RSS and DuckDuckGo aggregation engines.
   - Automatically generates high-converting, actionable video ideas based on detected domain patterns and recurring trends.

3. **ddg_serp_analysis**
   - Audits top search engine results pages (SERP) for any target keyword.
   - Computes algorithmic metrics:
     - Average title character length.
     - Presence of high-CTR hooks (numbers, brackets, parentheticals).
     - Recurring vocabulary and semantic keywords.
     - Concrete title optimization recommendations.

4. **ddg_content_fetch**
   - Retrieves full web pages and strips away navigation, scripts, ads, and footers.
   - Converts the core article body into clean, LLM-ready Markdown text.

## 🛠️ Architecture & Tech Stack

- **Runtime:** Node.js (v20+ or v24+ with native --experimental-strip-types)
- **Protocol:** Model Context Protocol (MCP) via @modelcontextprotocol/sdk
- **Parsing:** Cheerio XML/HTML parser
- **Zero API Keys:** Operates 100% on free, public, unauthenticated protocols.

## 📦 Installation & Setup

`ash
# Clone the repository
git clone https://github.com/ramedina-ia/duckduckgo-seo-mcp.git
cd duckduckgo-seo-mcp

# Install dependencies
npm install

# Run tests
npm test

# Run MCP server
npm run dev
`

### Claude Desktop / Antigravity MCP Configuration

Add to your mcp_config.json:

`json
{
  mcpServers: {
    duckduckgo-seo-mcp: {
      command: cmd.exe,
      args: [/c, path\\to\\duckduckgo-seo-mcp\\run.cmd]
    }
  }
}
`

## 📄 License

MIT License. Developed by Ramiro Medina.