# RankMySEO

RankMySEO is a Google rank tracker from madebyaris.com. It stores keyword positions over time.

Facts:
- We check the first 20 organic results. Past that, the row reads 20+.
- Every plan is checked once a week. Growth and above also get a limited daily queue. We do not check hourly.
- Free is 1 website, 3 keywords, and 14 days of history. No card. https://rankmyseo.com/free-rank-tracker
- Prices, including Starter at $5 / Rp50rb a month, live on https://rankmyseo.com/pricing

You can connect and try a site without a human making an account first.

This file is also https://rankmyseo.com/index.md and https://rankmyseo.com/auth.md. Any marketing URL on this origin answers `Accept: text/markdown` with the same text. The API catalog is https://rankmyseo.com/.well-known/api-catalog.

The ARD capability manifest is https://rankmyseo.com/.well-known/ai-catalog.json, also available at https://rankmyseo.com/.well-known/ard.json. It includes the public MCP server's connection details.

## Install the MCP server yourself

MCP endpoint (Streamable HTTP): https://api.rankmyseo.com/mcp

Do not send an Authorization header on the first request. The lobby exposes one tool: `register`. Call it. It returns a bearer token. Save the token and send `Authorization: Bearer <token>` on every later request.

Then call `add_project` with the website, then `add_keyword`.

### Cursor

Project file `.cursor/mcp.json`, or `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "rankmyseo": {
      "url": "https://api.rankmyseo.com/mcp"
    }
  }
}
```

Reload MCP. Call `register`. For later sessions, put the token on the server:

```json
{
  "mcpServers": {
    "rankmyseo": {
      "url": "https://api.rankmyseo.com/mcp",
      "headers": {
        "Authorization": "Bearer PASTE_TOKEN"
      }
    }
  }
}
```

### Claude Code or Claude Desktop

```json
{
  "mcpServers": {
    "rankmyseo": {
      "type": "http",
      "url": "https://api.rankmyseo.com/mcp"
    }
  }
}
```

Same flow: connect with no key, call `register`, then send the bearer token. After you have a token you can add a `headers.Authorization` field the same way as Cursor.

### Any Streamable HTTP client

POST https://api.rankmyseo.com/mcp with no Authorization, list tools, call `register`, then send `Authorization: Bearer <token>` on every later request.

## Walk-up limits

1 website, 2 keywords, 48 hours. Research is deleted after 24 hours. One guest bot per network.

To keep the site on a human's plan, call `request_link` and ask them to open the URL.

A human can also create a Free account at https://app.rankmyseo.com/signup (1 website, 3 keywords, weekly, no card). That is a lasting dashboard login. It is not the same as this walk-up guest key.

Checkout is open after a Free signup. Pick a paid plan in the dashboard. Indonesia pays with QRIS, a virtual account, or an e-wallet. USD is a card on that same page. Bugs and pre-sales still go to https://rankmyseo.com/support. We reply by email.

## If the human already has an account

They mint a lasting key on the Account screen (https://app.rankmyseo.com/account). Put that token in Authorization instead of calling `register`. Do not invent a REST signup — there is no public API for agents to create billed accounts.

## What you can ask

Keyword positions, rank history, on-page issues, competitors, backlink review on Starter. Disavow is in the dashboard, not over MCP. A lasting key from a signed-in account uses that account's plan — same gates as the dashboard. Starter keys can call `keyword_gap`, `competitor_traffic`, `keyword_planner`, `backlink_review`, `rank_compare`, `issue_pages`, `next_actions`, and `research_site`. Agency and Scale keys can also call `track_ai` (10 prompts a site on Agency, 25 on Scale). Walk-up guest keys stay at 1 site / 2 keywords; those tools stay listed but tell you to call `request_link`. Call `account_status` to see what this key can do.

## Self-host

Open-source toolkit: https://github.com/madebyaris/rankmyseo
`npm i rankmyseo`, then `npx rankmyseo install`.

## Guides

Plain markdown copies of the SEO guides. The HTML page is the same URL without `.md`.

- [How search engines find, index, and rank pages](https://rankmyseo.com/learn/how-search-works.md) (en): Learn how search engines work through 4 stages. Check discovery, crawl access, indexing, and search results before you decide what to change on a page.
- [How to choose keywords for your site](https://rankmyseo.com/learn/choose-keywords.md) (en): Choose SEO keywords in 4 steps: identify the reader, check search intent, compare estimates, and select a page. Follow a worked example for a small site.
- [How to check whether Google indexed your page](https://rankmyseo.com/learn/check-indexing.md) (en): Check if Google indexed a page with URL Inspection. Learn 5 common findings, how crawl rules differ from noindex, and what to check before requesting a visit.
- [How to write useful content for SEO](https://rankmyseo.com/learn/write-useful-content.md) (en): Write useful SEO content in 7 review steps. Build a brief, answer the question, add evidence, and check a before-and-after example before you publish the page.
- [SEO, AEO, and GEO: what each means for your site](https://rankmyseo.com/learn/seo-aeo-geo.md) (en): Understand SEO, AEO, and GEO with 1 customer example. Learn how search results and generated answers differ, what work overlaps, and which outcomes to measure.
- [How to check AI search access to your site](https://rankmyseo.com/learn/check-ai-search-access.md) (en): Check AI search access across 3 platforms. Separate search crawlers from training crawlers, review robots.txt and firewall rules, and record the result.
- [Cara kerja search engine](https://rankmyseo.com/belajar-seo/cara-kerja-mesin-pencari.md) (id): Pahami cara kerja search engine dalam 4 tahap. Cek penemuan URL, crawling, indexing, dan hasil pencarian sebelum memilih perbaikan pada halaman Anda.
- [Cara memilih keyword untuk website Anda](https://rankmyseo.com/belajar-seo/memilih-keyword.md) (id): Pilih keyword SEO dalam 4 langkah. Cek kebutuhan pembaca, hasil pencarian, perkiraan volume, dan halaman tujuan melalui contoh bengkel sepeda lokal.
- [Cara cek apakah halaman sudah diindeks Google](https://rankmyseo.com/belajar-seo/cek-indexing.md) (id): Cek indexing halaman melalui URL Inspection. Pahami 5 temuan umum, bedakan robots.txt dan noindex, lalu perbaiki penyebab sebelum meminta indexing lagi.
- [Cara menulis konten SEO](https://rankmyseo.com/belajar-seo/menulis-konten-seo.md) (id): Tulis konten SEO dengan 7 langkah pemeriksaan. Susun brief, jawab pertanyaan, tambahkan bukti, dan periksa contoh perbaikan sebelum menerbitkan halaman.
- [SEO, AEO, dan GEO: arti dan pekerjaan yang perlu dilakukan](https://rankmyseo.com/belajar-seo/seo-aeo-geo.md) (id): Pahami perbedaan SEO, AEO, dan GEO melalui 1 pertanyaan pelanggan. Bedakan hasil pencarian dan jawaban generatif, lalu pilih hasil yang perlu diukur.
- [Cara cek akses crawler AI search ke website](https://rankmyseo.com/belajar-seo/akses-ai-search.md) (id): Cek akses AI search pada 3 platform. Bedakan crawler pencarian dan pelatihan, periksa robots.txt serta firewall, lalu simpan hasil pemeriksaan halaman.
- [Cara cek ranking keyword di Google](https://rankmyseo.com/belajar-seo/cek-ranking-keyword.md) (id): Cek ranking keyword dengan 7 langkah yang bisa diulang. Catat pasar, posisi, dan URL. Bedakan hasil tracker dengan average position di Search Console.
- [Penyebab ranking Google turun dan cara memeriksanya](https://rankmyseo.com/belajar-seo/penyebab-ranking-turun.md) (id): Periksa 5 kemungkinan penyebab ranking turun: URL berbeda, rival naik, perubahan website, tampilan hasil, atau pembaruan Google. Mulai dari bukti halaman.
- [Cara mengukur visibilitas AI dan membaca hasilnya](https://rankmyseo.com/belajar-seo/mengukur-visibilitas-ai.md) (id): Ukur visibilitas AI dengan 5 catatan tes. Pisahkan penyebutan, kutipan, ketepatan fakta, referral, dan conversion. Pahami batas laporan tiap platform.
- [Tanya asisten AI tentang riwayat ranking Anda](https://rankmyseo.com/belajar-seo/tanya-ai-tentang-ranking.md) (id): Hubungkan asisten AI ke RankMySEO melalui MCP dalam 6 langkah. Minta data posisi, tanggal, dan URL agar Anda bisa memeriksa jawaban dari hasil tersimpan.
- [How to check keyword rankings in Google](https://rankmyseo.com/learn/check-keyword-rankings.md) (en): Check where your site ranks in Google for a keyword: set the country and language, read the top 20 results, and save each check so you can compare weeks.
- [Why your Google rankings changed](https://rankmyseo.com/learn/why-rankings-change.md) (en): 5 reasons a Google ranking moves: your page changed, a rival moved, Google picked another URL, the results page changed, or an update rolled out.
- [How to find keyword gaps with your competitors](https://rankmyseo.com/learn/keyword-gap-analysis.md) (en): Run a keyword gap analysis in 5 steps: pick real rivals, pull their keywords, split them into Missing and Losing, filter by intent, then track the best few.
- [On-page SEO checklist for every page](https://rankmyseo.com/learn/on-page-seo-checklist.md) (en): A 15-point on-page SEO checklist in 5 groups: indexing, titles and descriptions, headings and content, links and redirects, and speed. Fix the top rows first.
- [How to disavow backlinks, and when not to](https://rankmyseo.com/learn/disavow-backlinks.md) (en): Use Google's disavow backlinks tool only in 2 cases. Learn when to skip it, how to write the file with domain: lines, and how to upload it in Search Console.
- [How to track AI visibility and understand the results](https://rankmyseo.com/learn/track-ai-visibility.md) (en): Track AI visibility with a defined prompt set. Record mentions, citations, accuracy, and referrals separately. Learn 5 checks that make comparisons useful.
- [Ask Claude, Cursor, or ChatGPT where your site ranks](https://rankmyseo.com/learn/ask-ai-about-rankings.md) (en): Connect an AI assistant to your rank data over MCP in 5 steps. It can try 1 site and 2 keywords for 48 hours with no account, then keep the site on your plan.
- [SEO glossary](https://rankmyseo.com/learn/glossary.md) (en): 56 SEO, AEO, and GEO terms in plain English. Find definitions, examples, common mistakes, and practical lessons on search, content, reports, and AI answers.
- [Apa itu SEO?](https://rankmyseo.com/belajar-seo/seo-adalah.md) (id): SEO adalah cara membuat halaman website ditemukan di Google. Ini 3 bagiannya, cara Google memilih hasil, dan 4 langkah pertama untuk website Anda.
- [Riset keyword dari kompetitor](https://rankmyseo.com/belajar-seo/riset-keyword.md) (id): Riset keyword dalam 5 langkah: pilih kompetitor yang benar, ambil keyword mereka, pisahkan Missing dan Losing, saring menurut intent, lalu pantau yang Anda kerjakan.
- [Checklist optimasi SEO on-page](https://rankmyseo.com/belajar-seo/optimasi-seo-on-page.md) (id): 15 cek optimasi SEO on-page dalam 5 kelompok: indexing, title dan meta description, heading dan konten, link dan redirect, serta kecepatan halaman.
- [Cara disavow backlink, dan kapan tidak perlu](https://rankmyseo.com/belajar-seo/cara-disavow-backlink.md) (id): Kebanyakan website tidak perlu file disavow. Baca 2 syarat Google, format file domain:, dan cara mengunggah daftar melalui properti URL-prefix.
- [Kamus istilah SEO](https://rankmyseo.com/belajar-seo/kamus-seo.md) (id): 56 istilah SEO, AEO, dan GEO dalam bahasa Indonesia. Cari arti, contoh, kesalahan umum, dan panduan untuk memahami konten, indexing, ranking, serta jawaban AI.