README - alsoasked-mcp by metehan777

AlsoAsked MCP Server

A Model Context Protocol (MCP) server for the AlsoAsked API, providing access to Google's "People Also Ask" data for SEO research and content optimization.

Features

Search People Also Ask Questions: Get hierarchical PAA data for any search terms
Account Management: Check your API credits and account status
Flexible Search Options: Configure language, region, depth, and freshness
Rich Data Structure: Formatted results with question hierarchy and counts

Setup

1. Install Dependencies

npm install

2. Build the Project

npm run build

3. Get AlsoAsked API Key

Sign up for an AlsoAsked Pro account
Generate an API key from your dashboard
Keep your API key secure

4. Add to Claude Configuration

Add this to your Claude claude_desktop_config.json:

{
  "mcpServers": {
    "alsoasked": {
      "command": "node",
      "args": ["/path/to/your/alsoasked-mcp/dist/index.js"],
      "env": {
        "ALSOASKED_API_KEY": "your-api-key-here"
      }
    }
  }
}

5. Restart Claude Desktop

Restart Claude Desktop to load the new MCP server.

Usage

The server provides three main tools:

search_people_also_ask

Search for PAA questions with full control over parameters:

// Example: Search for marketing questions in Spanish for Mexico
{
  "terms": ["digital marketing", "content strategy"],
  "language": "es",
  "region": "mx", 
  "depth": 3,
  "fresh": true
}

search_single_term

Convenient method for single-term searches:

// Example: Quick search for a single term
{
  "term": "machine learning",
  "depth": 2
}

get_account_info

Check your account status and remaining credits:

// No parameters needed
{}

API Parameters

Parameter	Type	Default	Description
`terms`	string[]	required	Search terms to query
`language`	string	"en"	Language code (en, es, fr, etc.)
`region`	string	"us"	Region code (us, uk, ca, etc.)
`depth`	number	2	Question hierarchy depth (1-3)
`fresh`	boolean	false	Fetch fresh vs cached results
`async`	boolean	false	Process asynchronously

Response Format

The server returns structured data with:

Question Hierarchy: Nested questions with levels
Search Metadata: Total questions, search terms
Account Info: Credits remaining, plan details
Formatted Output: Clean JSON structure for easy parsing

Example Queries

Ask Claude:

"Use AlsoAsked to find People Also Ask questions for 'sustainable energy' with depth 3"

"Get PAA data for SEO keyword research on 'home workout equipment' in the UK market"

"Check my AlsoAsked account credits and usage"

Development

# Watch mode for development
npm run dev

# Build for production  
npm run build

# Start the server
npm start

alsoasked-mcp