# Organiq

> SEO and GEO analysis of your own Google Search Console and GA4 data: summaries, top queries and pages, CTR curve, content decay, cannibalization, opportunities and traffic from AI assistants. Google sign-in; read-only. Interface: an MCP server (Streamable HTTP) plus skills and this documentation. Portuguese and English.

## When to use Organiq

Use it when the user owns or manages a website verified in Google Search Console and asks about its organic search performance: clicks, impressions, CTR and position; which queries or pages grew or declined; pages losing traffic (decay); several pages competing for one query (cannibalization); queries with CTR below the expected for their position (quick wins, striking distance); brand vs non-brand share; the date a drop started and nearby Google updates; sessions coming from AI assistants (ChatGPT, Perplexity, Gemini, Copilot, Claude) via GA4.

Do not use it for: sites the user has not verified in Search Console; competitor data; keyword search volume or backlinks; clicks inside Google AI Overviews / AI Mode (Search Console does not separate them); any write operation (there are none).

## How an agent connects

- MCP endpoint (Streamable HTTP, POST): https://organiqgeo.com/mcp
- Authentication: OAuth 2.1 with PKCE S256. Unauthenticated protected calls return 401 with `WWW-Authenticate: Bearer resource_metadata="https://organiqgeo.com/.well-known/oauth-protected-resource/mcp"`. Client registration: Client ID Metadata Documents (preferred) or Dynamic Client Registration at https://organiqgeo.com/oauth/register. Scopes: mcp:read, mcp:write, offline_access. Alternative for clients without OAuth: `Authorization: Bearer <personal API key gy_live_…>`.
- Public tools that work before sign-in: get_capabilities, get_ctr_benchmark, check_connection.
- Protected resource metadata: https://organiqgeo.com/.well-known/oauth-protected-resource
- Authorization server metadata: https://organiqgeo.com/.well-known/oauth-authorization-server
- Server card: https://organiqgeo.com/.well-known/mcp/server-card.json
- MCP Registry entry: https://registry.modelcontextprotocol.io/v0/servers?search=com.organiqgeo%2Forganiq
- Agent Skills index: https://organiqgeo.com/.well-known/agent-skills/index.json
- Claude Code plugin: plugins/organiq in the product repository (skills + bundled connector)

## Setup guides by client

- Claude (web, desktop, mobile): https://organiqgeo.com/connect/claude (Português: https://organiqgeo.com/pt/connect/claude)
- Claude Code: https://organiqgeo.com/connect/claude-code (Português: https://organiqgeo.com/pt/connect/claude-code)
- Cursor and other MCP clients: https://organiqgeo.com/connect/cursor (Português: https://organiqgeo.com/pt/connect/cursor)
- ChatGPT: https://organiqgeo.com/connect/chatgpt (Português: https://organiqgeo.com/pt/connect/chatgpt)

## Documentation: English / Português

- English (canonical): https://organiqgeo.com/docs · privacy https://organiqgeo.com/privacy · terms https://organiqgeo.com/terms · home https://organiqgeo.com/
- Português: https://organiqgeo.com/pt/docs · privacidade https://organiqgeo.com/pt/privacy · termos https://organiqgeo.com/pt/terms · início https://organiqgeo.com/pt
- Full text for agents (English): https://organiqgeo.com/llms-full.txt
- Support: youssefpmat@gmail.com

## Units and defaults

clicks/impressions: integers; ctr: fraction 0–1 (0.052 = 5.2%); position: impression-weighted average, lower is better; dates: yyyy-mm-dd. Default period: 28 days ending on the last synced date (Search Console lags about 3 days). Default comparison: the previous window of the same length. Every response states the period and comparison used.

## Example questions

- How did example.com do in the last 28 days compared with the previous 28?
- Which queries grew the most and which lost clicks last month?
- Which pages are decaying compared with six months ago?
- Where are we cannibalizing: several pages ranking for the same query?
- Give me quick wins: queries with CTR below the expected for their position.
- How many sessions came from ChatGPT, Perplexity and Gemini this month?