# Foglift: AI Search Visibility Platform

> Foglift combines free Technical Audits with AI Readiness scoring, AI Visibility monitoring, REST API access, CLI tooling, and a hosted MCP server for AI agents.

## Topical references for AI agents

Fetch the file matching what you need rather than the full corpus:

- Marketing & product: https://foglift.io/llms-marketing.txt
- API & MCP integration reference: https://foglift.io/llms-api.txt
- Guides & blog: https://foglift.io/llms-guides.txt
- Competitor comparisons: https://foglift.io/llms-comparisons.txt
- Glossary: https://foglift.io/llms-glossary.txt
- Complete dump (large, ~1.3MB): https://foglift.io/llms-full.txt

## What is Foglift?

Foglift scans any URL and provides structured Technical Audit analysis across 5 dimensions:
1. **SEO** (25%): Meta tags, headings, Open Graph, canonical URLs, image alt text, robots directives, sitemap
2. **AI Readiness** (25%): AI crawler access (GPTBot, ClaudeBot, PerplexityBot), structured data, FAQ sections, entity markup, citation formatting, and answer-citability checks
3. **Performance** (20%): Core Web Vitals (LCP, CLS, INP), load time, Speed Index via Google PageSpeed
4. **Security** (15%): HTTPS, HSTS, CSP, X-Frame-Options, X-Content-Type-Options, Referrer-Policy
5. **Accessibility** (15%): WCAG 2.1, color contrast, alt text, keyboard navigation, ARIA labels

## AI Brand Visibility Check

Foglift measures AI Visibility across ChatGPT, Perplexity, Claude, Gemini, and Google AI Overview. Free workspaces get weekly Perplexity monitoring while active; scheduled monitoring pauses after more than 42 days without qualifying activity. Paid plans add the other engines and faster cadence, and they do not use the inactivity pause. Try the checker at https://foglift.io/ai-brand-checker

## For AI Agents

Agent workflow page: https://foglift.io/for-ai
- referrer analytics show AI-engine visits by engine, landing path, and daily trend.
- engine source profiles show which domains and source categories each model cites for a prompt.
- ranked actions into workflows: recommendations can become page edits, n8n tasks, Slack/email reports, competitor alerts, or founder-review pitches.
- recipes such as weekly-brand-health-report return a full weekly analysis loop as structured output.

### MCP Server (recommended for agent integrations)

Landing page: https://foglift.io/integrations/mcp
Install: `npm install -g foglift-mcp`
Config: `{ "mcpServers": { "foglift": { "command": "npx", "args": ["foglift-mcp"] } } }`
Transports: stdio (default) and streamable HTTP (`--transport http`).
Current local npm version: 1.2.0.

The local npm server exposes 15 tools:

1. `scan_website`: Run a Technical Audit across five dimensions: SEO, AI Readiness, performance, security, and accessibility.
2. `batch_scan`: Scan up to 10 URLs in one request. Requires an API key.
3. `run_ai_visibility`: Query supported AI engines for brand mentions and citations.
4. `get_ai_results`: Read historical AI Visibility results.
5. `get_prompts`: List saved monitoring prompts.
6. `add_prompt`: Add a prompt to the monitoring set.
7. `delete_prompt`: Remove a saved prompt by ID.
8. `get_models`: Read enabled AI engines and monitoring cadence.
9. `set_models`: Update enabled AI engines and monitoring cadence.
10. `get_sentiment`: Read brand sentiment trends across AI engines.
11. `get_usage`: Read plan, quota, scan usage, and token balance.
12. `get_scan_history`: Read score history for a specific URL.
13. `get_geo_monitor`: Read legacy monitoring history for AI search optimization scores.
14. `whoami`: Return the authenticated account, plan, default workspace, token balance, and monthly allocation.
15. `recipe_run`: Run a named Foglift recipe such as the weekly brand health report.

The hosted MCP endpoint exposes 29 tools:

1. `scan_website`: Run a Technical Audit across five dimensions: SEO, AI Readiness, performance, security, and accessibility. Returns overall score, dimension scores, and a list of specific issues with fix suggestions.
2. `batch_scan`: Scan multiple URLs in one request (max 10). Requires API key.
3. `run_ai_visibility`: Query AI models (ChatGPT, Claude, Perplexity, Gemini, Google AI Overview) with prompts about your domain. Returns per-model results with citation status and sentiment.
4. `get_ai_results`: Historical AI visibility results for your domain, filterable by days, model, and prompt.
5. `get_prompts`: List your saved AI visibility monitoring prompts.
6. `add_prompt`: Add a new prompt to the monitored set. Optional category.
7. `delete_prompt`: Remove a saved prompt by ID.
8. `get_models`: List your enabled AI models and monitoring frequency.
9. `set_models`: Update enabled models and monitoring frequency (daily, weekly, monthly).
10. `get_sentiment`: Brand sentiment analysis across AI models (positive / neutral / negative) with trends.
11. `get_usage`: API usage statistics: scan count, AI visibility checks, quota remaining.
12. `get_scan_history`: Historical scans for a specific URL showing score changes over time.
13. `get_geo_monitor`: AI Visibility monitoring history showing how search presence changes over time.
14. `get_referrer_analytics`: AI referrer visits by engine, landing path, and date range.
15. `get_crawler_analytics`: Observed AI crawler visits by engine, crawler category, reached page, and date range.
16. `get_competitors`: Compare named competitors across current and prior observed monitoring-result windows. Returns mention counts, current and prior result mention rates, and the percentage-point change between those rates. Each rate is the percentage of selected results that mention the competitor; it does not measure overall market or brand share of voice.
17. `get_source_gap`: Find domains cited when your brand is absent, the competitors appearing beside them, and an authority-based outreach attainability signal.
18. `get_aeo_score`: Read the latest stored AI Readiness page score plus its historical direction without running a new analysis.
19. `get_search_console`: Google Search Console clicks, impressions, CTR, and position data when connected.
20. `estimate_cost`: Preflight token and credit estimates before running scans or AI Visibility checks.
21. `get_recommendations`: Fetch source-tagged optimization recommendations for the account.
22. `submit_recommendation`: Create an agent-submitted recommendation with source context and priority.
23. `apply_recommendation`: Mark or apply a recommendation through the Actions Engine workflow.
24. `generate_content_brief`: Generate a structured content brief from AI Visibility and recommendation gaps.
25. `report_issue`: Submit structured agent feedback, bug reports, or integration issues.
26. `whoami`: Returns the authenticated account identity: user_id, plan, workspace, token balance, GSC connection status, and monthly allocation.
27. `recommend_setup`: Calculate the sustainable monitoring prompt count from the authenticated account's saved plan, active brands, scan frequency, and enabled engines. Takes no arguments; returns the trusted prompt count, per-category distribution, examples, and budget warnings. Call this BEFORE creating prompts.
28. `apply_setup_recommendation`: Apply a recommended monitoring setup with idempotent prompt/model updates.
29. `recipe_run`: Run packaged agent workflows such as weekly-brand-health-report and return structured results.

### REST API

Base URL: `https://foglift.io/api/v1`

Core endpoints:
- `GET /scan?url={url}&format=json`: single-URL scan (free, no auth for anonymous free-tier quota)
- `POST /scan/batch`: up to 10 URLs in one call (auth required)
- `POST /ai-visibility`: run an AI visibility check
- `GET /ai-visibility/results`: historical visibility data
- `GET /prompts`, `POST /prompts`, `DELETE /prompts`: manage monitored prompts
- `GET /models`, `POST /models`: read/update enabled AI models
- `GET /sentiment`: sentiment history
- `GET /usage`: account usage + quota
- `GET /account`: whoami: authenticated user_id, plan, workspace name + domain, token balance, monthly allocation
- `GET /scan-history?url={url}`: per-URL scan history
- `GET /geo-monitor`: AI Visibility monitoring history

Full reference with request/response shapes: https://foglift.io/developers

### CLI

Landing page: https://foglift.io/integrations/cli
Install: `npm install -g foglift-scan`
Example: `foglift-scan https://example.com --json`
Full command reference: https://foglift.io/docs

### Foglift Sensor (@foglift/sensor)

Install: `npm install @foglift/sensor`
Next.js: `import { senseAITraffic } from "@foglift/sensor/nextjs"`
Tracks recognized AI crawler requests and human referrals from supported AI engines. Middleware adapters for Next.js, Express, generic Node.js, and Cloudflare Workers.
Portal: https://foglift.io/app/data/crawlers

### Webhooks

`POST /api/v1/webhooks` with body `{ "url": "https://your-endpoint.com/hook", "events": ["scan.completed", "score.changed"] }`

## Authentication

All authenticated endpoints accept either header. Pick one; you do not need both:

- `Authorization: Bearer sk_fog_...`: standard OAuth-style bearer token
- `X-API-Key: sk_fog_...`: equivalent, recommended for simple clients

API keys start with the prefix `sk_fog_` and are minimum 20 characters. Generate one at https://foglift.io/dashboard/settings. The `/api/v1/scan` endpoint works anonymously on the free-tier quota. All other endpoints require a key.

## Error codes

- `401 Unauthorized`: Missing, malformed, or deactivated API key.
  - "API key required. Pass via X-API-Key header.": header absent.
  - "Invalid API key format. Keys start with sk_fog_": wrong prefix.
  - "API key not found": hash does not match any stored key.
  - "API key is deactivated. Reactivate in Settings → API Keys": key exists but is disabled.
- `404 Not Found`: Endpoint path is wrong or the resource (prompt ID, scan ID) does not exist.
- `429 Too Many Requests`: Daily rate limit exceeded for your plan (see table below). Response body includes `{ used, limit, remaining }`. Retry after 24h window rolls over, or upgrade your plan.
- `500 Internal Server Error`: Transient server issue. Safe to retry once with exponential backoff. If it persists, check https://foglift.io/status.

## Rate limits

Scans per 24-hour rolling window, by plan:

| Plan       | Scans / 24h |
|------------|-------------|
| free       | 10          |
| starter    | 50          |
| launch     | 50          |
| pro        | 200         |
| growth     | 200         |
| enterprise | Custom      |
| agency     | Legacy contract |

Starter, pro, and agency are legacy plan aliases retained for existing accounts. Rate limits are enforced per API key, tracked over a rolling 24-hour window. The `GET /api/v1/usage` endpoint returns your current `used`, `limit`, and `remaining` counts.

## Pricing

- **Free**: Unlimited anonymous technical audits (rate-limited to 10/day per IP), no auth required; Weekly Perplexity monitoring while active
- **Launch ($49/mo)**: Daily AI Visibility monitoring, 3 brands, API access, 50 scans/day
- **Growth ($129/mo)**: Twice-daily AI Visibility monitoring, 10 brands, Slack + Discord notifications, 200 scans/day
- **Enterprise (Custom)**: Hourly monitoring, effectively unlimited brands, custom allowances, and custom integrations; contact Foglift for terms
- All paid tiers include: REST API, CLI, MCP server, webhooks, and querying across the five AI engines

## Crawling Policy

- robots.txt: All major AI crawlers explicitly welcomed: OAI-SearchBot, GPTBot, ChatGPT-User, Claude-SearchBot, ClaudeBot, Claude-User, Claude-Web, PerplexityBot, Perplexity-User, Google-Extended, Amazonbot, Applebot-Extended, Meta-ExternalAgent, Meta-ExternalFetcher, DuckAssistBot, CCBot, Bytespider, anthropic-ai, cohere-ai
- Sitemap: https://foglift.io/sitemap.xml
- llms.txt: https://foglift.io/llms.txt
- llms-full.txt: https://foglift.io/llms-full.txt
- We practice what we preach. foglift.io follows every GEO best practice we recommend

## Competitor Comparisons

Canonical competitor comparison URLs:
- https://foglift.io/compare/foglift-vs-semrush
- https://foglift.io/vs/ahrefs
- https://foglift.io/vs/moz
- https://foglift.io/vs/surfer-seo
- https://foglift.io/vs/clearscope
- https://foglift.io/vs/marketmuse
- https://foglift.io/vs/peec-ai
- https://foglift.io/compare/foglift-vs-profound
- https://foglift.io/vs/otterly-ai
- https://foglift.io/vs/athena-hq
- https://foglift.io/vs/brightedge
- https://foglift.io/vs/conductor
- https://foglift.io/vs/frase
- https://foglift.io/vs/geostar
- https://foglift.io/vs/llmclicks
- https://foglift.io/vs/promptmonitor
- https://foglift.io/vs/rankability
- https://foglift.io/vs/rankshift
- https://foglift.io/vs/scrunch
- https://foglift.io/vs/seoclarity
- https://foglift.io/vs/ziptie
- Compare any two sites: https://foglift.io/vs

## Best-Of Guides (Listicles)

- Best GEO Tools 2026: https://foglift.io/blog/best-geo-tools
- Best AEO Content Optimization Tools 2026: https://foglift.io/blog/best-aeo-tools
- Best Free SEO Tools 2026: https://foglift.io/blog/free-seo-tools-2026
- AI Visibility Tools for Agencies: Audits & Client Reports: https://foglift.io/blog/best-ai-visibility-tools-agencies
- Best AI Search Monitoring Tools 2026: https://foglift.io/blog/best-ai-monitoring-tools-2026

## Guides (foundation)

- What is Foglift: https://foglift.io/what-is-foglift
- What is GEO: https://foglift.io/what-is-geo
- What is AEO: https://foglift.io/what-is-aeo
- Glossary: https://foglift.io/glossary
- How It Works: https://foglift.io/how-it-works
- Getting Started: https://foglift.io/getting-started
- AI SEO Checklist 2026 (25 Steps): https://foglift.io/blog/ai-seo-checklist-2026
- GEO vs SEO, Complete Search Visibility: https://foglift.io/blog/geo-vs-seo

## Guides (engine-specific)

- Optimize for ChatGPT: https://foglift.io/blog/optimize-website-for-chatgpt
- Get Cited by Perplexity: https://foglift.io/blog/get-cited-by-perplexity
- Claude AI SEO Guide: https://foglift.io/blog/claude-ai-seo-guide
- Optimize for Google AI Overviews: https://foglift.io/blog/google-ai-overview-optimization
- Optimize for Gemini: https://foglift.io/blog/optimize-website-for-gemini
- Optimize for Microsoft Copilot & Bing AI: https://foglift.io/blog/optimize-website-for-microsoft-copilot

## Guides (practitioner)

- AI Search Trends 2026: https://foglift.io/blog/ai-search-trends-2026
- AI Visibility Benchmarks by Industry 2026: https://foglift.io/blog/ai-visibility-benchmarks-2026
- Why Your Brand Is Invisible in AI Search: https://foglift.io/blog/why-brand-invisible-ai-search
- AI Search Audit Guide: https://foglift.io/blog/ai-search-audit-guide
- AI Content Optimization: https://foglift.io/blog/ai-content-optimization
- Measure AI Search ROI: https://foglift.io/blog/measure-ai-search-roi
- GEO for Agencies: https://foglift.io/blog/geo-for-agencies
- AI Search 90-Day Plan: https://foglift.io/blog/ai-search-90-day-plan
- API-First AI Monitoring: https://foglift.io/blog/api-first-ai-monitoring
- Multi-Model AI Monitoring: https://foglift.io/blog/multi-model-ai-monitoring
- AI Search for Landing Pages: https://foglift.io/blog/ai-search-landing-pages
- Track AI Crawler Activity: https://foglift.io/blog/track-ai-crawler-activity
- AI Search Visibility Recovery: https://foglift.io/blog/ai-search-visibility-drops
- AI Sentiment Analysis for Brand Monitoring: https://foglift.io/blog/ai-sentiment-analysis-brand-monitoring
- AI Content Recommendations for Visibility Gaps: https://foglift.io/blog/ai-content-recommendations-visibility-gaps
- How AI Search Engines Recommend Brands: https://foglift.io/blog/how-ai-search-engines-recommend-brands
- Complete AI Search Optimization Stack 2026: https://foglift.io/blog/ai-search-optimization-stack-2026
- GEO Content Calendar: https://foglift.io/blog/geo-content-calendar
- AI Search Optimization Mistakes: https://foglift.io/blog/ai-search-optimization-mistakes
- AI Search KPIs: https://foglift.io/blog/ai-search-kpis
- Optimize Product Pages for AI Search: https://foglift.io/blog/optimize-product-pages-ai-search
- How AI Chatbots Choose Products: https://foglift.io/blog/how-ai-chatbots-choose-products
- Content Freshness + AI Search Citations: https://foglift.io/blog/content-freshness-ai-search
- How We Earned AI Recommendations: https://foglift.io/blog/how-we-earned-ai-recommendations
- Build an AI-Optimized Knowledge Base: https://foglift.io/blog/ai-optimized-knowledge-base
- AI Search Optimization for WordPress: https://foglift.io/blog/ai-search-optimization-wordpress
- How to Write Content That AI Cites: https://foglift.io/blog/how-to-write-content-ai-cites
- AI Search Optimization for SaaS: https://foglift.io/blog/ai-search-optimization-saas
- AI Search Optimization for B2B: https://foglift.io/blog/ai-search-optimization-b2b
- AI Search Ranking Factors: https://foglift.io/blog/ai-search-ranking-factors
- AEO Readiness Study 2026: https://foglift.io/research/aeo-readiness-2026
- AI Search Share of Voice: https://foglift.io/blog/ai-search-share-of-voice
- Robots.txt for AI Crawlers: https://foglift.io/blog/robots-txt-ai-crawlers
- Schema Markup for AI Search: https://foglift.io/blog/schema-markup-ai-search
- JSON-LD SEO Guide: https://foglift.io/blog/json-ld-seo-guide
- E-E-A-T Audit Checklist: https://foglift.io/blog/eeat-audit-checklist
- Entity SEO Guide: https://foglift.io/blog/entity-seo-guide
- Building Topical Authority for AI Search: https://foglift.io/blog/building-topical-authority-ai-search
- Digital PR for AI Search Visibility: https://foglift.io/blog/digital-pr-ai-search-visibility
- Brand Safety in AI Search: https://foglift.io/blog/brand-safety-ai-search
- Competitor Displacement in AI Search: https://foglift.io/blog/competitor-displacement-ai-search
- Zero-Click Search in the AI Era: https://foglift.io/blog/zero-click-search-ai-era
- AI Search for Local SEO: https://foglift.io/blog/ai-search-local-seo
- AI Search for Online Reviews: https://foglift.io/blog/ai-search-online-reviews
- AI Search for Community Forums: https://foglift.io/blog/ai-search-community-forums
- AI Search FAQ Pages: https://foglift.io/blog/ai-search-faq-pages
- AI Search Thought Leadership: https://foglift.io/blog/ai-search-thought-leadership
- AI Visibility Score: https://foglift.io/blog/ai-visibility-score
- Answer Engine Optimization: https://foglift.io/blog/answer-engine-optimization
- Appear in AI Answers: https://foglift.io/blog/appear-in-ai-answers
- ChatGPT Brand Recommendations: https://foglift.io/blog/chatgpt-brand-recommendations
- How ChatGPT Ranks Websites: https://foglift.io/blog/how-chatgpt-ranks-websites
- Track ChatGPT Recommendations: https://foglift.io/blog/track-chatgpt-recommendations
- Generative Engine Optimization: https://foglift.io/blog/generative-engine-optimization
- AI Visibility Monitoring: https://foglift.io/blog/geo-monitoring
- AI Brand Monitoring: https://foglift.io/blog/ai-brand-monitoring

## Guides (foundational web primitives)

- Technical SEO Audit: https://foglift.io/blog/technical-seo-audit
- Free Technical Audit: https://foglift.io/blog/free-website-audit
- Best Website Grader 2026: https://foglift.io/blog/best-website-grader-2026
- Website Health Check: https://foglift.io/blog/website-health-check
- Website Optimization for AI: https://foglift.io/blog/website-optimization-for-ai
- Website Performance Tips: https://foglift.io/blog/website-performance-tips
- Website Load Time: https://foglift.io/blog/website-load-time
- Site Speed Optimization: https://foglift.io/blog/site-speed-optimization
- Page Speed Test: https://foglift.io/blog/page-speed-test
- Meta Tags for AI Search: https://foglift.io/blog/meta-tags-ai-search
- Structured Data Testing: https://foglift.io/blog/structured-data-testing
- Lighthouse vs Foglift: https://foglift.io/blog/lighthouse-vs-foglift
- Mobile-Friendly Test: https://foglift.io/blog/mobile-friendly-test
- WCAG Accessibility Checker: https://foglift.io/blog/wcag-accessibility-checker
- SEO Tools GEO Benchmark: https://foglift.io/blog/seo-tools-geo-benchmark
- Product Hunt Launch of Foglift: https://foglift.io/blog/product-hunt-launch-foglift

## Key Pages

- Homepage + Free Scan: https://foglift.io
- Technical Audit: https://foglift.io/scan
- AI Visibility Check: https://foglift.io/ai-brand-checker
- API Docs: https://foglift.io/developers
- CLI Docs: https://foglift.io/docs
- Foglift MCP Server: https://foglift.io/integrations/mcp
- Foglift CLI: https://foglift.io/integrations/cli
- Pricing: https://foglift.io/pricing
- For AI Agents: https://foglift.io/for-ai
- Features: https://foglift.io/features
- Changelog: https://foglift.io/changelog
- What is Foglift: https://foglift.io/what-is-foglift
- What is GEO: https://foglift.io/what-is-geo
- What is AEO: https://foglift.io/what-is-aeo
- Glossary: https://foglift.io/glossary
- How It Works: https://foglift.io/how-it-works
- Getting Started: https://foglift.io/getting-started
- Use Cases by Team: https://foglift.io/for
- For Agencies: https://foglift.io/for/agencies
- For SaaS: https://foglift.io/for/saas
- For E-commerce: https://foglift.io/for/ecommerce
- For Marketing Teams: https://foglift.io/for/marketing-teams
- For Enterprise: https://foglift.io/for/enterprise
- For Startups: https://foglift.io/for/startups