admin/metatron-open-seo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Onboarding agent: clarify OpenSEO analyzes any domain; keep recs in-product (#295)

Browse Source
This commit is contained in:
Ben Senescu 2026-06-24 15:19:17 -04:00 committed by GitHub
parent 327d741d4c
commit 2087d0d614
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
src/server/features/onboarding/OnboardingChatAgent.ts
View File

@ -47,6 +47,8 @@ function buildSystemPrompt(domain: string | null): string {
"When users want advice from people in the community, a second opinion, or help beyond this onboarding chat, mention the OpenSEO Discord from the fact sheet.", "When users want advice from people in the community, a second opinion, or help beyond this onboarding chat, mention the OpenSEO Discord from the fact sheet.",
"When the user asks how OpenSEO helps them get traffic or rank higher, lead with the fact sheet's SEO strategy framing: positioning, topical authority, focused early topics, then expansion into broader searches. Do not answer as only a feature list.", "When the user asks how OpenSEO helps them get traffic or rank higher, lead with the fact sheet's SEO strategy framing: positioning, topical authority, focused early topics, then expansion into broader searches. Do not answer as only a feature list.",
"This chat is the free onboarding preview: the user hasn't upgraded yet. Here you can answer questions and analyze their site with your tools, but they can't act inside OpenSEO yet — connecting Google Search Console, rank tracking, content tools, and the full research workflows all unlock on the paid plan. In ANY reply, you may describe what OpenSEO will do for them after they upgrade, but never tell them to do those things now and never hand them a to-do list of off-platform SEO work. Be direct that these unlock on the paid plan, but do not hard-sell.", "This chat is the free onboarding preview: the user hasn't upgraded yet. Here you can answer questions and analyze their site with your tools, but they can't act inside OpenSEO yet — connecting Google Search Console, rank tracking, content tools, and the full research workflows all unlock on the paid plan. In ANY reply, you may describe what OpenSEO will do for them after they upgrade, but never tell them to do those things now and never hand them a to-do list of off-platform SEO work. Be direct that these unlock on the paid plan, but do not hard-sell.",
"Keep recommendations inside OpenSEO; don't point users to other SEO tools.",
"When a request is beyond your preview tools, don't conclude OpenSEO can't do it — describe what the full product does per the fact sheet, and don't claim capabilities the fact sheet doesn't list.",
"You have three tools to analyze THIS user's own site. Use them whenever the user asks you to analyze their site, recommend a strategy, or for any site-specific advice. Never state a metric, search volume, or keyword difficulty you did not get from a tool.", "You have three tools to analyze THIS user's own site. Use them whenever the user asks you to analyze their site, recommend a strategy, or for any site-specific advice. Never state a metric, search volume, or keyword difficulty you did not get from a tool.",
"- read_website: reads their pages as plain text. Always available.", "- read_website: reads their pages as plain text. Always available.",
"- get_seo_metrics: their estimated organic traffic, ranking-keyword count, and the keywords they already rank for (each with real search volume and difficulty). May report it's unavailable for brand-new sites or unsupported markets.", "- get_seo_metrics: their estimated organic traffic, ranking-keyword count, and the keywords they already rank for (each with real search volume and difficulty). May report it's unavailable for brand-new sites or unsupported markets.",

9
src/server/features/onboarding/openseo-fact-sheet.md
View File

@ -88,13 +88,13 @@ OpenSEO MCP tools cover workflows such as:
- Keyword research with volume, difficulty, CPC, intent, and trends. - Keyword research with volume, difficulty, CPC, intent, and trends.
- Live Google organic SERP inspection. - Live Google organic SERP inspection.
- Domain and page ranked keyword research. - Domain and page ranked keyword research for any domain, including competitors.
- SERP competitor comparisons. - SERP competitor comparisons.
- Local business, Maps, Local Finder, and Google Business Profile Q&A research. - Local business, Maps, Local Finder, and Google Business Profile Q&A research.
- Saved keyword listing and saving. - Saved keyword listing and saving.
- Rank tracker config and latest position reads. - Rank tracker config and latest position reads.
- Domain organic footprint summaries. - Domain organic footprint summaries for any domain, including competitors.
- Backlink and referring-domain overview data. - Backlink and referring-domain overview data for any domain, including competitors.
- Google Search Console performance reads. - Google Search Console performance reads.
- Google URL inspection reads. - Google URL inspection reads.
@ -105,7 +105,7 @@ OpenSEO also provides agent skills for workflows such as SEO project setup, SEO
OpenSEO's app includes these practical workflows: OpenSEO's app includes these practical workflows:
- Keyword research: expand seed topics into keyword ideas, compare search volume, difficulty, CPC, intent, and SERP context, then save useful opportunities. - Keyword research: expand seed topics into keyword ideas, compare search volume, difficulty, CPC, intent, and SERP context, then save useful opportunities.
- Domain overview: understand a domain's organic footprint and ranking keywords. - Domain overview: understand any domain's organic footprint and ranking keywords — including competitors and other third-party sites, not just the user's own site. Domains are looked up one at a time and use credits.
- Backlink research: inspect backlinks, referring domains, target URLs, link quality signals, and competitor link profiles. - Backlink research: inspect backlinks, referring domains, target URLs, link quality signals, and competitor link profiles.
- Rank tracking: track keyword positions over time. - Rank tracking: track keyword positions over time.
- Site audit: crawl pages and inspect technical page-level signals such as status codes, titles, meta descriptions, headings, indexability, image alt coverage, links, response time, and optional Lighthouse findings. - Site audit: crawl pages and inspect technical page-level signals such as status codes, titles, meta descriptions, headings, indexability, image alt coverage, links, response time, and optional Lighthouse findings.
@ -118,6 +118,7 @@ After subscribing, a hosted user can:
- Set up Google Search Console from onboarding or the app. - Set up Google Search Console from onboarding or the app.
- Use the OpenSEO app workflows, including keyword research, domain research, backlinks, rank tracking, and site audits. - Use the OpenSEO app workflows, including keyword research, domain research, backlinks, rank tracking, and site audits.
- Research any domain — their own or a competitor's — with domain overview, ranked keywords, and backlink data (one domain at a time, using credits).
- Connect OpenSEO to an AI client through MCP. - Connect OpenSEO to an AI client through MCP.
- Install OpenSEO skills for agent-driven SEO workflows. - Install OpenSEO skills for agent-driven SEO workflows.
- Use the monthly included credits and buy top-up credits if needed. - Use the monthly included credits and buy top-up credits if needed.