geo-analyzer

@houtini-ai/geo-analyzer

0 Stars 8 次浏览 houtini-ai 更新于 2026-08-23

AI search optimization analysis with actionable findings and gap analysis

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "@houtini/geo-analyzer": {
      "args": [
        "@houtini/geo-analyzer@2.1.2"
      ],
      "command": "npx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

GEO Analyzer

${badge_line}

Content analysis for AI search visibility. Measures what actually matters for getting cited by ChatGPT, Claude, Perplexity, and Google AI Overviews.

# What It Does

GEO Analyzer examines content for the signals AI systems use when selecting sources to cite:

Claim Density - Extractable facts per 100 words
Information Density - Word count vs predicted AI coverage
Answer Frontloading - How quickly key information appears
Semantic Triples - Structured (subject, predicate, object) relationships
Entity Recognition - Named entities AI can reference
Sentence Structure - Optimal length for AI parsing

The analysis runs locally using Claude Sonnet 4.5 for semantic extraction. No external services, no data leaving your machine.

# Installation

# # Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "geo-analyzer": {
      "command": "npx",
      "args": ["-y", "@houtini/geo-analyzer@latest"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-..."
      }
    }
  }
}

Config locations:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop after saving.

# # Requirements

Node.js 20+
Anthropic API key (console.anthropic.com)

# Usage Examples

# # Analyse a Published URL

Analyse https://example.com/article for "topic keywords"

The topic context helps score relevance but isn't required:

Analyse https://example.com/article

# # Analyse Text Directly

Paste content for analysis (minimum 500 characters):

Analyse this content for "sim racing wheels":

[Your content here]

# # Summary Mode

Get condensed output without detailed recommendations:

Analyse https://example.com/article with output_format=summary

# Output

# # Scores (0-10)

# # Key Metrics

Information Density:

Word count with coverage prediction
Optimal range: 800-1,500 words
Pages under 1K words: ~61% AI coverage
Pages over 3K words: ~13% AI coverage

Answer Frontloading:

Claims and entities in first 100/300 words
First claim position
Score indicating answer immediacy

Claim Density:

Target: 4+ claims per 100 words
Extractable facts, statistics, measurements

Sentence Length:

Target: 15-20 words average
Matches Google's ~15.5 word chunk extraction

# # Recommendations

Prioritised suggestions with:

Specific locations in content
Before/after examples
Rationale based on research

# Tools

# # analyze_url

Fetches and analyses published web pages.

| Parameter | Required | Description |
|- -- -- -- -- --|- -- -- -- -- -|- -- -- -- -- -- --|
| url | Yes | URL to analyse |
| query | No | Topic context for relevance scoring |
| output_format | No | detailed (default) or summary |

# # analyze_text

Analyses pasted content directly.

# Troubleshooting

"ANTHROPIC_API_KEY is required"
Add your API key to the env section in config.

"Cannot find module" after config change
Restart Claude Desktop completely.

"Content too short"
Minimum 500 characters required for meaningful analysis.

Paywalled content returns errors
The analyser can only access publicly available pages.

# Performance

URL analysis: ~8-10 seconds
Text analysis: ~5-7 seconds
Cost: ~$0.14 per analysis (Sonnet 4.5)

# Migration from v1.x

v2.0 removed external dependencies. Update your config:

Old (v1.x):

{
  "env": {
    "GEO_WORKER_URL": "https://...",
    "JINA_API_KEY": "jina_..."
  }
}

New (v2.x):

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

# Development

git clone https://github.com/houtini-ai/geo-analyzer.git
cd geo-analyzer
npm install
npm run build

# Research Foundation

The analysis methodology draws from peer-reviewed research and empirical studies:

# # MIT GEO Paper (2024)

Aggarwal et al., "GEO: Generative Engine Optimization" - ACM SIGKDD

Key findings applied:

Claim density target of 4+ per 100 words
Optimal sentence length of 15-20 words
40% improvement in AI citation rates with extractability focus

arxiv.org/abs/2311.09735

# # Dejan AI Grounding Research (2025)

Empirical analysis of 7,060 queries and 2,275 pages