AI-Enhanced Citation Checker - NAP Audit with Correction Suggestions

AI-Powered Citation Audit Tool - Check NAP (Name, Address, Phone) consistency across 36+ directories with Claude AI analysis. Get AI-generated correction suggestions, prioritized fix actions, and SEO impact estimates. Checks Google, Yelp, Facebook, Bing Places, Apple Maps, Yellow Pages, BBB, and more. BYOK (Bring Your Own Key) - use your Anthropic API key for AI features. Essential for local SEO agencies and multi-location businesses. Built by John Rippy (https://www.linkedin.com/in/johnrippy/ | https://johnrippy.link/).

Features

Core Citation Checking

• 36+ Directories - Google, Yelp, Facebook, Bing, Apple Maps, BBB, and more
• NAP Consistency - Detects mismatches in business name, address, phone
• Listing Status - Shows found, missing, correct, or incorrect
• Industry-Specific - Healthcare (Healthgrades), Legal (Avvo), Restaurant (TripAdvisor, OpenTable)

AI Analysis (BYOK - Bring Your Own Key)

Provide your Anthropic API key to unlock Claude AI-powered features:

• Correction Suggestions - AI recommends specific fixes for each platform
• Priority Actions - Ranked list of what to fix first for maximum impact
• SEO Impact Estimate - Predicted ranking improvement if corrections are made
• Health Score - 0-100 citation health rating

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Required	Description
businessName	Yes	Exact name as it should appear
city	Yes	City where business is located
state	Yes	State abbreviation (e.g., NY, CA)
address	No	Street address
phone	No	Business phone number
website	No	Business website URL
platforms	No	Specific platforms to check (defaults to all)
providedUrls	No	Pre-known listing URLs for faster checking
anthropicApiKey	No	Your Anthropic API key for AI features
enableAiAnalysis	No	Enable/disable AI analysis (default: true)
demoMode	No	Return sample data without scraping
webhookUrl	No	URL to POST results when complete

Output Format

Standard Output

{
  "summary": {
    "total": 36,
    "correct": 24,
    "incorrect": 4,
    "missing": 6,
    "found": 2
  },
  "citations": [
    {
      "platform": "Google Business",
      "status": "correct",
      "url": "https://maps.google.com/...",
      "nameMatch": true,
      "addressMatch": true,
      "phoneMatch": true
    }
  ]
}

With AI Analysis

{
  "summary": { ... },
  "citations": [ ... ],
  "aiAnalysis": {
    "overallHealthScore": 72,
    "summary": "Your citations are moderately healthy...",
    "correctionSuggestions": [
      {
        "platform": "Yelp",
        "field": "phone",
        "currentValue": "(555) 123-4567",
        "suggestedCorrection": "555-987-6543",
        "priority": "high",
        "reasoning": "Yelp is a high-authority directory..."
      }
    ],
    "prioritizedActions": [
      "Claim and update your Bing Places listing",
      "Fix phone number on Yelp to match GBP",
      "Add suite number to Facebook Business address"
    ],
    "estimatedImpact": "Fixing these issues could improve local pack visibility by 15-25%..."
  }
}

Pricing

This actor uses pay-per-event billing:

Event	Cost
Base run	$0.10
Per directory checked	$0.01
AI Analysis (uses your own API key)	$0.00

Example costs:

• Check 20 directories (no AI): $0.30
• Check 36 directories + AI: $0.46 + your Anthropic API usage

Use Cases

1. Local SEO Agencies - Audit client citations at scale
2. Multi-Location Businesses - Monitor NAP consistency across locations
3. Franchise Operations - Ensure brand consistency across directories
4. Reputation Management - Find and fix incorrect listings

---

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal