🎯 SEO Research & Keyword Explorer

Zero-cost keyword research powered by Google Autocomplete. Find high-opportunity long-tail keywords, analyze SERP competition, and extract People Also Ask questions — all without any paid API.

---

What This Actor Does

Input a seed keyword → Get a complete SEO research report:

✅ 100-300 long-tail keywords from Google Autocomplete permutations
✅ KGR Opportunity Score (0-100) for each keyword
✅ Search intent classification (Informational / Commercial / Transactional / Navigational)
✅ People Also Ask (PAA) questions with answer snippets
✅ SERP weak spot detection (Reddit, Quora, Forum presence)

Cost: $0 — No paid APIs required. All data comes from free Google endpoints.

---

🚀 Quick Start

Option 1: Use on Apify (No Code)

1. Click "Try for free" above
2. Enter your seed keyword (e.g. ai video generator)
3. Click "Run"
4. Download results as JSON, CSV, or Excel

Option 2: Use as MCP Server (For AI Agents)

Connect to Cursor, Claude Desktop, or Hermes for AI-powered SEO research:

{
  "mcpServers": {
    "seo-research": {
      "command": "python",
      "args": ["path/to/mcp_server.py"]
    }
  }
}

Then ask your AI Agent: "Research keywords for 'best project management tool'"

---

📥 Input Parameters

Parameter	Type	Default	Description
seedKeywords	string[]	["ai video generator"]	1-10 seed keywords to research
geo	string	"us"	Country code: us, uk, de, jp, etc.
language	string	"en"	Language code: en, es, zh-CN, etc.
maxKeywords	integer	300	Max keywords per seed (10-1000)
enablePAA	boolean	true	Extract People Also Ask questions
enableSerpSignals	boolean	true	Detect Reddit/Quora weak spots
outputFormat	string	"detailed_json"	"detailed_json" or "agent_compact"

---

📤 Output Example

Summary Report (agent_compact mode)

# 🎯 SEO Keyword Report: `ai video generator` (US / en)

**Summary**: Discovered **168** keywords | 🔥 **24 High-Opportunity Wins** | ❓ **8 PAA Questions**

### 🏆 Top Opportunity Keywords

| # | Keyword | Intent | Opportunity | KGR | Volume |
|---|---|---|---|---|---|
| 1 | `ai video generator free without watermark` | Transactional | 🌟 95 | 0.05 | Medium |
| 2 | `how to make ai video for youtube free` | Informational | 🌟 92 | 0.08 | Medium |
| 3 | `ai video generator vs capcut` | Commercial | ⚡ 72 | 0.28 | High |

Detailed JSON Output

{
  "seed": "ai video generator",
  "summary": {
    "total_keywords_found": 168,
    "high_opportunity_count": 24,
    "total_paa_found": 8
  },
  "keywords": [
    {
      "keyword": "ai video generator free without watermark",
      "search_intent": "transactional",
      "metrics": {
        "opportunity_score": 95,
        "kgr_score": 0.05,
        "estimated_volume_tier": "Medium (1k-10k)"
      }
    }
  ],
  "people_also_ask": [
    {
      "question": "Which AI can generate video from text for free?",
      "snippet_answer": "Several tools provide free text-to-video..."
    }
  ]
}

---

🔌 MCP Integration (AI Agents)

Available Tools

Tool	Description
research_keywords	Expand seed → long-tail matrix + KGR + PAA
analyze_serp_competition	Check SERP for weak spots (Reddit/Quora)

Cursor / Claude Desktop Config

{
  "mcpServers": {
    "seo-research": {
      "command": "python",
      "args": ["G:/path/to/seo-research-mcp/mcp_server.py"],
      "env": { "PYTHONPATH": "" }
    }
  }
}

Example Agent Prompt

"Use the research_keywords tool to find long-tail keywords for 'best CRM for small business'. Then create an SEO article outline targeting the top 5 opportunity keywords."

---

❓ FAQ

Q: How does the zero-cost model work?

A: We use Google's free Autocomplete API (suggestqueries.google.com/complete/search) which requires no API key. For competition analysis, we use algorithmic heuristics (KGR proxy) instead of paid tools like Ahrefs or SEMrush.

Q: What is KGR (Keyword Golden Ratio)?

A: KGR is a metric that estimates competition by comparing the number of search results to keyword volume. A KGR < 0.25 indicates a "golden" opportunity — low competition, high chance to rank on page 1 with quality content.

Q: How accurate are the search volume estimates?

A: Volume tiers (High/Medium/Low/Long-tail) are algorithmic estimates based on Google Trends data and keyword characteristics. They're directional, not exact. For precise volumes, consider integrating DataForSEO or Keywords Everywhere (BYOK mode coming soon).

Q: Can I use this for non-English keywords?

A: Yes! Set language and geo parameters. Tested with: English, Spanish, German, French, Japanese, Chinese, Korean, Portuguese, Italian, Dutch.

Q: What's the difference between detailed_json and agent_compact?

A:

• detailed_json: Full structured data, best for data pipelines and analysis
• agent_compact: Token-optimized Markdown, best for AI agents (saves 70%+ tokens)

Q: How many keywords can I get per run?

A: Default is 300 per seed keyword. You can set maxKeywords from 10 to 1000. With 10 seed keywords, expect 1000-3000 total keywords.

Q: Is there rate limiting?

A: Google Autocomplete is lenient (10-20 concurrent requests work fine). SERP scraping may hit rate limits — use Apify Proxy for production workloads.

Q: Can I export to CSV/Excel?

A: Yes! After the Actor run, go to Dataset → Export → choose CSV, JSON, Excel, or XML.