1. MCP Server Setup (All 11 Tools with 1 Config)
Connecting via Model Context Protocol (MCP) gives your AI assistant (Claude Desktop, Cursor, Windsurf) instant access to ALL 11 diagnostic and audit tools automatically.
Add this block to your claude_desktop_config.json file:
{
"mcpServers": {
"site-analyzer-free": {
"url": "https://siteanalyzerfree.com/api/v1/agent/mcp.php",
"headers": {
"Authorization": "Bearer agent_sk_live_YOUR_KEY_HERE"
}
}
}
}
2. REST API Snippets by Report Type
Select any report offering below to copy ready-to-use cURL, Python, Node.js, and PHP integration code.
Quick Technical SEO Checkup
1 CREDIT / SCANRuns a fast 153-point technical diagnostic scanning titles, meta tags, security headers, canonical redirects, DNS, and mobile responsiveness. Returns a 0-100 score, priority issue breakdown, and pass lists.
POST https://siteanalyzerfree.com/api/v1/agent/checkup.php
import requests
url = "https://siteanalyzerfree.com/api/v1/agent/checkup.php"
headers = {
"Authorization": "Bearer agent_sk_live_YOUR_KEY",
"Content-Type": "application/json"
}
payload = {
"domain": "example.com",
"format": "json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
Available Tools & Capabilities
Our MCP server exposes 5 free diagnostic tools and 2 paid technical audit scanners.
lookup_whois_and_domain_age
Looks up domain creation date, expiration date, domain age in years, registrar, and nameservers for any website.
domain (e.g. "example.com")
check_noindex_status
Instantly checks if a domain or URL is blocked from search engine indexation via noindex, nofollow, X-Robots-Tag, or robots.txt.
domain (e.g. "example.com")
check_dns_and_headers
Analyzes SSL certificate validity, HTTP security headers (HSTS, CSP, X-Frame-Options), SPF/DMARC email security, and DNS TTL records.
domain (e.g. "example.com")
check_web_hosting
Identifies web server software, hosting provider, server IP address, CDN provider (Cloudflare, Fastly, etc.), and response headers.
domain (e.g. "example.com")
analyze_web_page_word_count
Counts total words vs main article content words, reading time, readability score, and top keyword density for any URL or raw text.
url or text
get_credit_balance
Retrieves current API key credit balance, active status, and account details directly via MCP or REST API.
run_quick_seo_checkup
Runs a fast technical SEO checkup on any domain (1 credit deducted from agent balance). Returns score (0-100), categorized issues, and pass lists.
domain, format ("json" | "markdown")
run_spider_view_scan
Simulates Googlebot & AI crawlers to inspect raw pre-rendered HTML text vs. CSR, discovered links, and meta robots indexability (1 credit).
domain
check_tech_stack
Identifies web server software, CMS platform, CDN provider, SSL certificate details, and security header configuration (1 credit).
domain
run_dns_snapshot_check
Captures current DNS zone records (A, MX, TXT, SPF, DMARC) and computes diffs against historical zone snapshots (1 credit).
domain
check_brand_reputation
Scans review platforms, Google Business Profile presence, local NAP directory consistency, and AI brand citations (5 credits).
domain, brand_name (optional)
run_keyword_report
Generates a full Website Keyword & Autocomplete Intelligence Report with search volumes, rankings, intent mapping, striking distance keywords, and unbranded report link ($7 USD / 70 credits).
domain, format ("json" | "markdown")
run_full_seo_audit
Executes a deep, multi-page 30+ check technical SEO audit report ($39 fee deducted from agent balance) with actionable remediation steps.
domain
API Key Credit Packages
Choose a credit pack for immediate activation or key top-up. AI agents can also purchase programmatically.
100 Credits
100 Quick Checkups
($0.100 per credit)
300 Credits
300 Quick Checkups
($0.083 per credit)
1,000 Credits
1,000 Quick Checkups
($0.070 per credit)
2,500 Credits
2,500 Quick Checkups
($0.060 per credit)
Manage Your API Keys & Check Balances
Log into your Account Dashboard to generate secret tokens, regenerate or revoke keys, and monitor real-time credit balances. Programmatic access is available via GET /api/v1/agent/balance.php.
Official CLI Tool • Zero Setup Terminal Automation
Autonomous agents, developers, and CI/CD pipelines can script SiteAnalyzerFree™ directly from the shell without configuring custom HTTP clients. Published on npm as siteanalyzerfree.
siteanalyzerfree ai-readiness example.com --json
siteanalyzerfree metadata https://example.com --json
checkup <domain>, ai-readiness <domain>, metadata <url>, url <url>, dns <domain>, changes <url>, contacts <url>, balance, audit <domain>. Pass --api-key <token> or export SITEANALYZERFREE_API_KEY.
Rate Limits & Real-Time Throttling
To allow autonomous agents and automated workflows to self-throttle without trial-and-error, every API response emits standard IETF RFC RateLimit headers:
Also includes backward-compatible X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers. On HTTP 429, a structured JSON error body with code RATE_LIMIT_EXCEEDED is returned.
Technical Specifications & Endpoints
| Specification | URL / Endpoint |
|---|---|
| Official CLI Tool | npx siteanalyzerfree <command> (npm: siteanalyzerfree) |
| Agent Instructions & When-To-Use | https://siteanalyzerfree.com/AGENTS.md |
| MCP Server Endpoint | https://siteanalyzerfree.com/api/v1/agent/mcp.php |
| Credit Balance Lookup REST API | https://siteanalyzerfree.com/api/v1/agent/balance.php |
| OAuth Protected Resource (RFC 9728) | https://siteanalyzerfree.com/.well-known/oauth-protected-resource |
| OAuth Authorization Server (RFC 8414) | https://siteanalyzerfree.com/.well-known/oauth-authorization-server |
| OpenAPI 3.0 Spec | https://siteanalyzerfree.com/openapi.json |
| llms.txt Machine Standard | https://siteanalyzerfree.com/llms.txt |