OpenSEO MCP server
85 operations0 webhooks
Open-source SEO platform with 85 operations: keyword research and metrics, live Google SERPs, domain and backlink analysis, rank tracking, local SEO and Google Business Profiles, site audits, AI visibility tracking across ChatGPT, Claude, Gemini and Perplexity, Search Console, Google Analytics, IndexNow and saved reports.
Try OpenSEO with your agent
Connect OpenSEO, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in OpenSEO on my account, then run one read-only example and show me the result.
OpenSEO tools and triggers
Tools are what your agent can do in OpenSEO through Corsair's MCP server. Triggers are the OpenSEO events a routine can start from.
Ai Visibility
- Complete Research SetupDestructive
Set up Prompt Research keywords for a project (can turn on weekly paid AI checks)
aiVisibility.completeResearchSetup
- Estimate CostRead-only
Estimate the cost of AI visibility checks without running them
aiVisibility.estimateCost
- Explore PromptDestructive
Ask a prompt in ChatGPT, Claude, Gemini or Perplexity and see answers, citations and brand mentions
aiVisibility.explorePrompt
- ExportRead-only
Export stored AI visibility observations as a CSV or JSON download link
aiVisibility.export
- Generate PromptsDestructive
Generate topic and prompt suggestions for AI visibility tracking
aiVisibility.generatePrompts
- Get AnswerRead-only
Get one stored AI answer with its prompt, mentions and citations
aiVisibility.getAnswer
- Get ResultsRead-only
Get how often the brand and competitors appear in AI answers for a run
aiVisibility.getResults
- Get RunRead-only
Get the progress of an AI visibility check
aiVisibility.getRun
- Get SourcesRead-only
List the pages or domains AI answers cited in a run
aiVisibility.getSources
- Get TrackerRead-only
Get a project's AI visibility tracking setup: topics, prompts, engines and schedule
aiVisibility.getTracker
- Get TrendRead-only
Compare recent AI visibility with the previous period
aiVisibility.getTrend
- Research PromptsRead-only
Find questions people ask AI about a keyword, with ChatGPT's answers and sources
aiVisibility.researchPrompts
- Run CheckDestructive
Start a one-off paid AI visibility check now
aiVisibility.runCheck
- Save TrackerWrite
Create or update AI visibility tracking prompts, topics, engines and market
aiVisibility.saveTracker
- Set ScheduleDestructive
Turn scheduled AI visibility checks on, change the cadence or pause them
aiVisibility.setSchedule
- Update Research KeywordsWrite
Add or remove a project's saved Prompt Research keywords
aiVisibility.updateResearchKeywords
Google Analytics
- Audience BreakdownRead-only
Break down visitors by device, country or new versus returning
googleAnalytics.audienceBreakdown
- Ecommerce PerformanceRead-only
Get GA4 ecommerce item views, add-to-carts, purchases and revenue
googleAnalytics.ecommercePerformance
- Key EventsRead-only
Get GA4 key events (conversions) by event or organic landing page
googleAnalytics.keyEvents
- List PropertiesRead-only
List the GA4 properties of the connected Google accounts
googleAnalytics.listProperties
- Measurement HealthRead-only
Check how Google Analytics is set up on the connected property
googleAnalytics.measurementHealth
- Organic Landing PagesRead-only
Get the landing pages that receive organic search traffic
googleAnalytics.organicLandingPages
- Organic OverviewRead-only
Get top-line organic search sessions, users and key events with a trend
googleAnalytics.organicOverview
- Page PerformanceRead-only
Get page views, users, engagement and key events per page
googleAnalytics.pagePerformance
- Set PropertyWrite
Set which GA4 property a project reads
googleAnalytics.setProperty
- Site SearchRead-only
Get the terms visitors search for on the site
googleAnalytics.siteSearch
- Traffic AcquisitionRead-only
Compare traffic by channel group, source/medium or campaign
googleAnalytics.trafficAcquisition
Local
- Business ProfileRead-only
Get a Google Business Profile by name, CID or place ID
local.businessProfile
- Business QuestionsRead-only
Get the questions and answers on a Google Business Profile
local.businessQuestions
- Business ReviewsRead-only
Get a business's Google reviews with ratings and owner replies
local.businessReviews
- Business UpdatesRead-only
Get the posts published on a Google Business Profile
local.businessUpdates
- List CategoriesRead-only
List Google Business categories ranked by how many businesses use them
local.listCategories
- Rank GridRead-only
Map a business's Google Maps rank across a grid of points around a center
local.rankGrid
- Search BusinessesRead-only
Search local business listings near a coordinate
local.searchBusinesses
- Serp ResultsRead-only
Get Google Maps or Local Finder results for a keyword from a coordinate
local.serpResults
Rank Tracking
- Add KeywordsWrite
Add keywords to a rank tracker
rankTracking.addKeywords
- CreateWrite
Create a rank tracker for a project
rankTracking.create
- Estimate CostRead-only
Estimate what a rank check costs without running it
rankTracking.estimateCost
- GetRead-only
List a project's rank trackers or get one with its latest Google positions
rankTracking.get
- HistoryRead-only
Get the position history of a rank tracker's keywords
rankTracking.history
- Pin KeywordsWrite
Pin or unpin tracked keywords
rankTracking.pinKeywords
- Remove KeywordsDestructive
Stop tracking keywords in a rank tracker
rankTracking.removeKeywords
- RunDestructive
Start a paid rank check now for every keyword in a tracker
rankTracking.run
Reports
- DeleteDestructive
Delete a saved report and its shared link
reports.delete
- Delete TemplateDestructive
Delete a report template
reports.deleteTemplate
- GetRead-only
Get a saved report with its summary and share link
reports.get
- ListRead-only
List a project's saved reports
reports.list
- List TemplatesRead-only
List a project's report templates
reports.listTemplates
- SaveWrite
Save an HTML report to a project
reports.save
- Save TemplateWrite
Save a reusable report template to a project
reports.saveTemplate
- Set SharingDestructive
Turn public sharing of a saved report on or off
reports.setSharing
Site Audits
- DeleteDestructive
Delete a site audit with its pages, issues and Lighthouse results
siteAudits.delete
- IssuesRead-only
Get the prioritized issues from a completed site audit
siteAudits.issues
- LighthouseRead-only
Get the Lighthouse results from a site audit
siteAudits.lighthouse
- ListRead-only
List a project's site audits with status and page counts
siteAudits.list
- PagesRead-only
List the pages a site audit crawled with per-page SEO data
siteAudits.pages
- RunWrite
Start a background site audit (crawl, SEO checks, optional Lighthouse)
siteAudits.run
- StatusRead-only
Get the progress of a site audit
siteAudits.status
Keywords
- List SavedRead-only
List a project's saved keywords with cached volume, difficulty, CPC and tags
keywords.listSaved
- MetricsRead-only
Get search volume, difficulty, intent, CPC and trends for a list of keywords
keywords.metrics
- Remove SavedDestructive
Delete saved keywords from a project by ID
keywords.removeSaved
- ResearchRead-only
Find keyword ideas for 1-5 seed keywords with volume, difficulty, CPC and intent
keywords.research
- SaveWrite
Save keywords to a project, optionally with metrics and tags
keywords.save
- SuggestionsRead-only
Suggest up to 10 seed keywords to research next from Search Console and saved keywords
keywords.suggestions
Projects
- CreateWrite
Create a project with a name and optional domain and market
projects.create
- Get ContextRead-only
Get a project's shared memory: overview, goal, positioning, competitors and key pages
projects.getContext
- ListRead-only
List projects with their ID, name, domain and default market
projects.list
- Research WebsiteDestructive
Research a project's website to draft its brand, overview, competitors and prompt topics
projects.researchWebsite
- Save Website SetupWrite
Save a drafted website setup (brand, overview, competitors, topics) to a project
projects.saveWebsiteSetup
- Update ContextWrite
Add, edit or delete entries in a project's shared memory
projects.updateContext
Search Console
- Inspect UrlsRead-only
Check whether Google has indexed up to 10 pages, and why not
searchConsole.inspectUrls
- List SitesRead-only
List the Search Console properties of the connected Google accounts
searchConsole.listSites
- OpportunitiesRead-only
Find pages ranking 4-20 in Search Console that are most worth improving
searchConsole.opportunities
- PerformanceRead-only
Get Search Console clicks, impressions, CTR and position by query, page or other dimension
searchConsole.performance
- Set SiteWrite
Set which Search Console property a project reads
searchConsole.setSite
Domains
- KeywordsRead-only
List the organic keywords a domain ranks for, with position and metrics
domains.keywords
- OverviewRead-only
Estimate a domain's monthly organic traffic and ranking keyword count
domains.overview
- Ranked KeywordsRead-only
List the keywords a domain or page ranks for in one country, with ranking URL and traffic
domains.rankedKeywords
Serp
- CompetitorsRead-only
Find the domains that compete in Google results for a set of keywords
serp.competitors
- ResultsRead-only
Get live Google organic results for 1-10 keywords
serp.results
- Search LocationsRead-only
Find the exact location name of a city or region for local searches
serp.searchLocations
Backlinks
- ListRead-only
List a domain's or page's individual backlinks with anchors and authority, paginated
backlinks.list
- OverviewRead-only
Summarize a domain's or page's backlinks, referring domains and authority
backlinks.overview
Account
- WhoamiRead-only
Get the connected OpenSEO account, token scopes and remaining credits
account.whoami
Index Now
- Submit UrlsDestructive
Notify IndexNow search engines (Bing, Yandex and others) that pages changed
indexNow.submitUrls
Connect OpenSEO to Claude, ChatGPT or Cursor
- 1
Connect OpenSEO in Corsair
Add your OpenSEO API key once in Corsair. Corsair stores the credential encrypted and makes the OpenSEO API calls for your agent, so it never goes into a prompt or a config file. Connect OpenSEO
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs OpenSEO. On a ChatGPT personal plan, connect OpenSEO here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, OpenSEO's read and write operations run right away and its 14 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/openseo, add the OpenSEO plugin, and connect with an API key. Then call methods like corsair.openseo.api.account.whoami() from your app. Corsair keeps each tenant isolated.
Yes. OpenSEO requires an API key from your OpenSEO account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit OpenSEO, GitHub, Notion, Stripe, and the rest. Trigger OpenSEO from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for open-source SEO platform with 85 operations: keyword research and metrics, live Google SERPs, domain and backlink analysis, rank tracking, local SEO and Google Business Profiles, site audits, AI visibility tracking across ChatGPT, Claude, Gemini and Perplexity, Search Console, Google Analytics, IndexNow and saved reports. Common builds include sync jobs, admin tooling, and agents that call OpenSEO APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per OpenSEO API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/openseo in the open repo. When OpenSEO ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your OpenSEO data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store OpenSEO data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put OpenSEO on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 14 destructive OpenSEO operations. You can change a link's mode at hub.corsair.dev/me.