GETTING STARTED
Your first research session.
1. Join your team
Open the invitation sent by your administrator. Create an account with the invited email address using Google or email and password, verify your email if prompted, then accept the invitation. Existing members can sign in directly. On a new installation, the first visitor creates the administrator account.
2. Set up your project
Follow the onboarding steps to create a project for your domain. Choose the market that matters to your business when researching keywords and search results.
3. Investigate a focused question
For example, a small coffee shop might start with “coffee subscription” and a few related terms. Compare the search demand and results before saving a shortlist. This is an example of a workflow, not a claim about those keywords' performance.
4. Review team access
Projects belong to your native OpenSEO workspace. Administrators can invite teammates from organization settings. Research has no trial credit balance; the operator manages the connected providers. Read the access policy for details.
5. Connect your assistant
Open Connect your assistant in FollowEngine. Copy the native setup prompt into an agent that can configure MCP, such as Codex or Claude Code. Use the self-hosted endpoint https://app.followengine.com/mcp directly and install the public SEO skills where supported. You still sign in and authorize your own workspace.
In a regular ChatGPT or Claude chat, add a custom remote MCP connection in the assistant's settings using the full URL above. Select OAuth, sign in to FollowEngine, and approve the connection. The available controls depend on the client and workspace policy. A pasted prompt cannot install a connection by itself, and a local Codex connection does not connect ChatGPT web.
If your client needs an API key, create one in FollowEngine Settings and put it in the client's secure configuration as a Bearer token. Keep keys out of chat and repositories.
The OpenSEO marketplace plugin connects to a separate hosted service. Use the custom FollowEngine connection for your FollowEngine account and projects.
Install SEO skills
MCP provides tools. Skills add workflows for audits, keyword research, competitor analysis and reports. Download the public SEO skills bundle and its SHA-256 manifest. The setup prompt can compare the checksum and install the skill folders with their supporting files. These workflows originate from OpenSEO and keep their existing names; they use your FollowEngine connection.
For manual installation in Codex, extract the archive and copy the folders inside skills/ into ~/.agents/skills/. Check for existing folders first and preserve personal edits. For Claude Code, use ~/.claude/skills/. Install for the agent you use, then reload if the skills do not appear.
For clients with skill upload controls, upload the individual ZIP for each workflow you want. Each ZIP contains one skill and its supporting files:
- ai-prompt-research
- ai-visibility-audit
- competitive-landscape
- competitor-analysis
- keyword-clustering
- keyword-research
- link-prospecting
- local-seo
- seo-audit
- seo-coach
- seo-project-setup
- seo-report
If your assistant does not support skills, you can still use FollowEngine tools with plain-language requests. Do not claim skills are installed until the assistant can discover them.
Check the connection
Start a new chat if needed and ask: “Use FollowEngine to check my account and list my projects.” Confirm the account and project list before running research. Setup does not need paid data queries. Research uses the same configured providers as the web application.
Update tools and skills
Return to Connect your assistant and copy the update prompt. It keeps your MCP address and authorization, refreshes tools where supported, and checks installed skill files separately. Server updates arrive when FollowEngine deploys; installed skills need a separate update.
For a manual skill update, download the latest bundle and manifest, verify the SHA-256, compare your installed workflows, and back up the folders you replace. Preserve personal edits and the existing installation scope. For a client with upload controls, replace the corresponding individual skills. Reload and verify skill discovery again.
Connect Search Console and Google Analytics
Open your project, then Settings > Integrations. Choose Connect with Google for Search Console or Google Analytics, review the requested read-only permissions, and select a Search Console site or GA4 property that your Google account can access. Each integration is optional and is authorized separately from Google sign-in.
Search Console powers search performance and URL inspection. Analytics provides traffic, acquisition, landing page, event and measurement reports. The integrations cannot edit your Google data. Project members and assistants you authorize can retrieve connected reports according to workspace permissions. Read how we use, share and delete Google data before connecting.
Use Disconnect in the project's integration settings to stop that project from fetching data. To remove a saved authorization, use Manage Google accounts and remove the account, or revoke FollowEngine in your Google Account. Saved reports and chat history require separate deletion. If Google reports an expired authorization, reconnect the affected integration and select the site or property again.
Account and support
Use the sign-in page to reset a forgotten password. For account, data or service questions, contact support@followengine.com from the email associated with your account. Never email your password or API keys.