For Developers
Foglift API & MCP Server
Scan any website for SEO + GEO issues right from your terminal, CI/CD pipeline, or AI coding assistant. Free tier included — no API key required.
Quick Start
Make a GET request to the scan endpoint. No authentication needed for basic scans.
# Scan a website (JSON response)
curl "https://foglift.io/api/v1/scan?url=example.com"
# Plain text output (great for terminal)
curl "https://foglift.io/api/v1/scan?url=example.com&format=text"API Reference
/api/v1/scanParameters
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | The URL to scan (e.g., example.com or https://example.com) |
format | string | No | "json" (default) or "text" for terminal-friendly output |
Example Response
{
"url": "https://example.com",
"scores": {
"overall": 72,
"seo": 85,
"geo": 60,
"performance": 78,
"security": 45,
"accessibility": 90
},
"topIssues": [
{
"category": "GEO",
"severity": "critical",
"title": "No structured data for AI engines",
"description": "Add JSON-LD structured data..."
},
{
"category": "Security",
"severity": "critical",
"title": "Missing HSTS header",
"description": "Enable HTTP Strict Transport Security..."
}
],
"totalIssues": 8,
"fullReport": "https://foglift.io/scan/abc123",
"upgrade": "https://foglift.io/pricing",
"_meta": {
"tool": "Foglift",
"version": "1.0",
"docs": "https://foglift.io/developers"
}
}Rate Limits
| Tier | Rate Limit | Issues Shown | Price |
|---|---|---|---|
| Free API | 10 scans/day | Top 3 issues | $0 |
| Deep Scan | Per URL | All issues + AI plan | $9 one-time |
| Pro | Unlimited | All issues + AI plan | From $129/mo |
MCP Server for AI Coding Assistants
Use Foglift directly in Claude Code, Cursor, or any MCP-compatible AI assistant. Get SEO + GEO analysis while you build your website.
Install via npm
npx foglift-mcpClaude Code Setup
Add this to your ~/.claude/mcp.json or project .mcp.json file:
{
"mcpServers": {
"foglift": {
"command": "npx",
"args": ["foglift-mcp"]
}
}
}Available tools: scan_website and check_geo_score. Both return detailed analysis with scores and issues.
Use in Any Terminal
# Quick scan from your terminal
curl -s "https://foglift.io/api/v1/scan?url=mysite.com&format=text"
# JSON for scripts and CI/CD
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores'
# Check GEO readiness
curl -s "https://foglift.io/api/v1/scan?url=mysite.com" | jq '.scores.geo'Use Cases
CI/CD Pipeline
Add SEO + GEO checks to your deployment pipeline. Catch issues before they go live.
AI Coding Assistants
Let Claude Code, Cursor, or Copilot check your site's SEO while you build it.
Client Reports
Agencies can automate website audits for client proposals and ongoing monitoring.
Monitoring Scripts
Build custom monitoring that tracks your SEO + GEO scores over time.
Ready to integrate?
Start scanning for free. No API key required.