.codex-plugin/plugin.json

{
  "name": "harborrank",
  "version": "1.0.1",
  "description": "SEO research on live Google data: keywords, SERPs, competitors, site audits, and your own Search Console and Google Analytics, with nine guided SEO workflows.",
  "author": {
    "name": "HarborRank",
    "email": "support@harborrank.com",
    "url": "https://harborrank.com"
  },
  "homepage": "https://harborrank.com/features/mcp",
  "repository": "https://github.com/winsley-jeune/harborrank-skills",
  "license": "MIT",
  "keywords": [
    "seo",
    "keyword-research",
    "serp",
    "backlinks",
    "search-console",
    "google-analytics",
    "site-audit",
    "local-seo",
    "rank-tracking"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "HarborRank",
    "shortDescription": "SEO with live Google data",
    "longDescription": "HarborRank brings live Google search data and your own Search Console and Google Analytics into the conversation, so you can do SEO by asking.\n\nWhat you can do:\n- Keyword research: search volume, keyword difficulty, CPC, intent and monthly trends, plus ideas from seed topics or a domain.\n- Live Google results: organic SERPs and local Maps packs for any location, and the domains that compete with you.\n- Competitor research: a site's ranking keywords, estimated organic traffic, top pages and backlink overview.\n- Site audits: crawl a site for broken pages, redirects, missing or duplicate titles, noindex, canonicals and thin content.\n- Search Console (read-only): clicks, impressions, CTR and position by query, page, country and date, plus URL inspection to see why a page is not indexed.\n- Google Analytics (read-only): conversions and revenue per landing page joined with Search Console, and visits referred by AI assistants.\n- Projects: saved keyword lists and rank-tracker positions you set up in HarborRank.\n- Local lead research for agencies: find local businesses on Google Maps and build a one-page SEO teardown for each.\n\nNine guided workflows come with the plugin: an SEO coach for beginners, project setup, keyword research, keyword clustering, competitive landscape, competitor analysis, SEO audit and traffic-drop diagnosis, link prospecting, and local lead teardowns.\n\nWho it's for: small business owners, marketers, content writers and SEO freelancers or agencies who want real search data without learning an enterprise SEO suite.\n\nLimitations: you need a HarborRank account (sign in when you connect). Search Console and Google Analytics data appear only after you connect those properties in HarborRank, and access is read-only. Some features, such as full backlink profiles and lead teardowns, are not available on every HarborRank plan. Search data comes from DataForSEO and reflects Google at the time of the request.",
    "developerName": "HarborRank",
    "category": "Data & Analytics",
    "capabilities": [
      "Keyword research with volume, difficulty and intent",
      "Live Google organic and local Maps results",
      "Competitor rankings, traffic and backlinks",
      "Technical SEO site audits",
      "Read-only Search Console performance and URL inspection",
      "Read-only Google Analytics landing page and AI referral reports"
    ],
    "websiteURL": "https://harborrank.com",
    "supportURL": "https://harborrank.com/docs",
    "privacyPolicyURL": "https://harborrank.com/privacy",
    "termsOfServiceURL": "https://harborrank.com/terms-and-conditions",
    "defaultPrompt": [
      "Find low-competition keywords for a plumber in Boston.",
      "Why does my competitor outrank me on Google? Compare my site with theirs.",
      "Audit my website for technical SEO problems and rank the fixes."
    ],
    "brandColor": "#1F4E8C",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/icon.png"
  },
  "extensions": {
    "com.openai": {
      "onboardingSkill": "./skills/seo-coach/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Keyword metrics for seed terms",
              "prompt": "What's the search volume and keyword difficulty for 'emergency plumber boston' and 'water heater repair boston'?",
              "tools_triggered": "get_keyword_metrics",
              "expected_behavior": "Returns US search volume, keyword difficulty, CPC and intent for both keywords in a table, with a short note on which is easier to rank for."
            },
            {
              "description": "Live Google results for a query",
              "prompt": "Show me the top 10 Google results for 'best running shoes for flat feet'.",
              "tools_triggered": "get_serp_results",
              "expected_behavior": "Lists the current top organic results with position, title, domain and URL, and summarizes the content types that rank."
            },
            {
              "description": "Domain overview of a competitor",
              "prompt": "Give me an SEO overview of rei.com: estimated organic traffic and its top ranking keywords.",
              "tools_triggered": "get_domain_overview, get_ranked_keywords",
              "expected_behavior": "Reports estimated organic traffic and keyword counts for rei.com and lists top ranking keywords with position and volume."
            },
            {
              "description": "Local Maps pack for a service",
              "prompt": "Who shows up in the Google Maps results for 'dentist' in Salem, Massachusetts?",
              "tools_triggered": "get_local_serp_results",
              "expected_behavior": "Lists the businesses in the local pack with rank, name, rating, review count and website where available."
            },
            {
              "description": "Account and projects for the signed-in user",
              "prompt": "Which HarborRank projects do I have, and what keywords are saved in the first one?",
              "tools_triggered": "list_projects, list_saved_keywords",
              "expected_behavior": "Lists the demo account's projects and the saved keywords of the first project; if none are saved, says so without inventing any."
            }
          ],
          "negative": [
            {
              "description": "Writing content is outside the plugin's tools",
              "prompt": "Write me a 1,500-word blog post about summer recipes."
            },
            {
              "description": "Requests to change a live website",
              "prompt": "Log into my WordPress site and change the homepage title tag."
            },
            {
              "description": "Unrelated personal question",
              "prompt": "What's the weather in Boston tomorrow?"
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/XPx8w1CsmoE",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Fixes the sign-in step from the first review: when you connect from ChatGPT, the HarborRank sign-in page now opens with the email and password form, so the test account signs in directly with no extra setup or verification. Includes keyword research, live Google SERPs and Maps packs, competitor research, site audits, read-only Search Console and Google Analytics, and nine guided SEO workflows."
      }
    }
  },
  "apps": "./.app.json"
}