Ranki.io SEO/AEO consultant

chính thức

Máy chủ MCP SEO và AEO miễn phí biến Claude / Cursor / ChatGPT Desktop của bạn thành chuyên gia tư vấn SEO + AEO cao cấp. Kiểm tra bất kỳ URL nào, tạo sitemap.xml / llms.txt / robots.txt, phát hiện khoảng trống từ khóa, và chỉ dẫn AI của bạn chính xác những gì cần sửa — tất cả đều sử dụng tín dụng AI của riêng bạn, không bao giờ dùng của chúng tôi.

Bạn có thể làm gì với Ranki Io SEO AEO Consultant MCP?

  • Kiểm tra SEO trên trang — Chạy audit_seo trên bất kỳ URL nào để nhận bảng điểm 0–100 bao gồm tiêu đề, mô tả meta, canonical, độ phủ alt ảnh và sự hiện diện của JSON-LD kèm công thức sửa lỗi cho từng lỗi.
  • Kiểm tra Tối ưu hóa Công cụ Trả lời — Sử dụng audit_aeo để kiểm tra schema FAQPage, phần giới thiệu định nghĩa, llms.txt, quyền của bot AI và tiêu đề kiểu trả lời để trang web của bạn được ChatGPT và Claude trích dẫn.
  • Đo lường Core Web Vitals và tốc độ — Gọi audit_speed hoặc audit_core_web_vitals để lấy điểm Lighthouse thực tế và các chỉ số LCP/CLS/INP, sau đó nhận các lệnh tối ưu hóa hình ảnh chính xác qua optimize_images.
  • Tạo các tệp SEO thiết yếu — Tạo robots.txt, sitemap.xml, llms.txt và schema JSON-LD sẵn sàng triển khai chỉ trong một bước với seo_starter_kit hoặc các công cụ generate_* riêng lẻ.
  • Tìm cơ hội nội dung — Yêu cầu find_topic_ideas để có bản tóm tắt có cấu trúc gồm 15 chủ đề bài viết theo ý định, hoặc sử dụng find_keyword_gap để khám phá các từ khóa mà đối thủ xếp hạng còn bạn thì không.
  • Phân loại các trang ẩn — Chạy audit_hidden_pages trên toàn bộ tên miền để xác định các đường dẫn quản trị, bản nháp và trang noindex, sau đó nhận một khối robots.txt sẵn sàng để dán.

Tài liệu

Ranki MCP — Tư vấn SEO, AEO, tốc độ và tối ưu hình ảnh miễn phí cho Cursor, Claude Code, Windsurf và ChatGPT

MCP không chỉ báo cáo — agent của bạn sẽ sửa lỗi. Kiểm tra mọi URL về SEO và Tối ưu hóa cho Công cụ Trả lời, đo lường Core Web Vitals thực tế qua Google PageSpeed Insights, và hướng dẫn agent của bạn chuyển đổi hình ảnh sang AVIF và WebP, viết lại thẻ <img> thành <picture> đáp ứng với srcsetalt, thêm schema JSON-LD, tạo sitemap.xml / llms.txt / robots.txt, phân loại trang ẩn — sau đó chạy lại kiểm tra để chứng minh điểm số đã thay đổi. Tất cả bên trong Claude Code, Claude Desktop, Cursor, Windsurf và ChatGPT Desktop.

MCP 2024-11-05 License: MIT npm @ranki.io/mcp live mcp.ranki.io Skill repo

Cài đặt chỉ với một dòng lệnh

npx @ranki.io/cli install

CLI tự động phát hiện trình soạn thảo AI bạn đã cài đặt (Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT Desktop), ghi cấu hình MCP phù hợp vào đúng vị trí và tải xuống tệp Kỹ năng đồng hành từ kho ranqi-seo-skills. Chạy lại npx @ranki.io/cli update sau đó để làm mới Kỹ năng; npx @ranki.io/cli check xác minh thiết lập.

Thích đoạn JSON thủ công hơn? Ví dụ cho từng trình soạn thảo có trong phần Cài đặt bên dưới.

Hai cách triển khai, cùng bộ công cụ

Repo này cung cấp MCP dưới hai cách triển khai tương đương để bạn có thể chọn cái phù hợp với stack của mình:

  • server/ — Tham chiếu PHP 8.4, triển khai sản xuất cung cấp năng lượng cho mcp.ranki.io. Được lưu trữ, bảo mật, không phụ thuộc, chạy sau Cloudflare. Đây là nền tảng mà mcp.ranki.io được xây dựng.
  • ts-server/ — Tham chiếu Node / TypeScript, được xuất bản dưới dạng @ranki.io/seo-aeo-mcp trên npm. Giải pháp thay thế Node gốc cho các nhà phát triển thích công cụ JavaScript, có thể cài đặt qua npx -y @ranki.io/seo-aeo-mcp (stdio) hoặc npx @ranki.io/seo-aeo-mcp --serve (HTTP).

Cả hai đều cung cấp cùng 22 công cụ với cùng đầu ra JSON, bảo vệ SSRF, ngữ nghĩa giới hạn tốc độ và tư thế bảo mật. Bản triển khai TS chạy 15 công cụ miễn phí gốc trong Node, và ủy quyền 7 công cụ cầu nối trả phí tới cùng API REST tại app.ranki.io mà máy chủ PHP sử dụng. Không cái nào mở cơ sở dữ liệu — các công cụ trả phí đi qua phần mềm trung gian ApiKeyAuth của Laravel và được giới hạn trong dữ liệu của người dùng gọi.

Nó thực sự làm gì — 22 công cụ

Máy chủ MCP cung cấp 22 công cụ. Agent của bạn gọi chúng như bất kỳ công cụ MCP nào khác; chúng trả về báo cáo Markdown mà agent của bạn hiển thị nội tuyến và sau đó hành động — chuyển đổi tệp, viết lại HTML, tạo tệp mới, commit kết quả.

Kiểm tra

  • audit_seo(url) — Thẻ điểm SEO on-page 10 kiểm tra: độ dài tiêu đề, mô tả meta, tính duy nhất H1, canonical, viewport, HTTPS, độ hoàn chỉnh OpenGraph, phạm vi alt hình ảnh, số lượng liên kết nội bộ, sự hiện diện JSON-LD. Trả về điểm 0–100 với công thức sửa lỗi cho từng lỗi.
  • audit_aeo(url) — Thẻ điểm Tối ưu hóa Công cụ Trả lời 8 kiểm tra: FAQPage / Article JSON-LD, giới thiệu định nghĩa dưới 80 từ, dòng tác giả, sự hiện diện llms.txt, robots.txt cho phép GPTBot / ClaudeBot / PerplexityBot, tiêu đề H2/H3 kiểu trả lời, bảng so sánh.
  • audit_hidden_pages(urls, domain) — phân loại mỗi đường dẫn là robots-disallow, noindex, keep hoặc unsure với lý do. Bắt các tuyến quản trị, điểm cuối API, bản nháp, trang đăng nhập, bảng điều khiển tài khoản, trang cảm ơn, tạo phẩm xây dựng và URL kết quả tìm kiếm. Trả về khối robots.txt sẵn sàng để dán.

Tốc độ và hình ảnh — đây là phần không gì khác làm được

  • audit_speed(url, strategy) — điểm Lighthouse thực tế (Hiệu suất, Khả năng tiếp cận, SEO, Thực hành tốt nhất) và Core Web Vitals (LCP, CLS, INP, FCP, TTFB) qua Google PageSpeed Insights. Trả về cơ hội hình ảnh với byte tiết kiệm mỗi tệp, JS / CSS chặn hiển thị, và các kiểm tra SEO on-page thất bại. Chiến lược mặc định là mobile (Google xếp hạng ưu tiên di động).
  • audit_core_web_vitals(url) — một đoạn cho mỗi chỉ số với công thức sửa chữa cụ thể. "Phần tử LCP là hero.png ở 2.4 MB, chuyển đổi sang WebP tiết kiệm 1.8 MB → -1.1s LCP." Chọn URL phần tử LCP từ Lighthouse để agent biết chính xác tệp nào cần tối ưu.
  • optimize_images(images, max_width) — cho mỗi hình ảnh: định dạng mục tiêu (AVIF + WebP), độ rộng đáp ứng 1×/2×, gợi ý văn bản alt, các lệnh sharp-cli / cwebp / avifenc cụ thể, và khối <picture> sẵn sàng để dán với srcset. Agent của bạn chạy chuyển đổi cục bộ trong repo và viết lại các thẻ <img>.

Tạo

  • generate_sitemap_xml(urls) — xây dựng sitemap.xml sẵn sàng triển khai từ danh sách URL với dấu thời gian lastmod hiện tại.
  • generate_llms_txt(site_name, summary, key_pages) — tạo llms.txt, tiêu chuẩn mới nổi để cho trình thu thập AI biết trang web của bạn là gì và trang nào cần trích dẫn.
  • generate_robots_txt(sitemap_url, allow_ai, disallow_paths) — xây dựng robots.txt cho phép hoặc từ chối rõ ràng GPTBot, ChatGPT-User, ClaudeBot, anthropic-ai, PerplexityBot và Google-Extended.

Nội dung và chiến lược

  • seo_starter_kit(domain) — trả về bốn tệp cơ sở mà hầu hết các trang web vibe-code đều thiếu (robots.txt, sitemap.xml, llms.txt, JSON-LD) sẵn sàng để dán vào repo của bạn.
  • find_topic_ideas(url) — đọc trang chủ của bạn, suy ra lĩnh vực của bạn, và trả về một bản tóm tắt có cấu trúc để tạo 15 chủ đề bài viết trên các mục đích thông tin, thương mại và giao dịch với tiêu chí ưu tiên.
  • find_keyword_gap(url, competitors) — trả về phương pháp từng bước để tìm từ khóa mà đối thủ xếp hạng nhưng bạn thì không. Nếu không có đối thủ nào được đưa ra, hướng dẫn trình soạn thảo của bạn hỏi trước.
  • propose_titles_metas(urls, focus_keyword) — trích xuất tiêu đề thực tế, h1 và đoạn đầu tiên từ mỗi URL (hoặc chấp nhận mô tả văn bản tự do cho các trang chưa triển khai), sau đó trả về bảng Markdown với 5 ứng viên tiêu đề và mô tả meta cho mỗi trang trên 5 góc độ (mô tả, dẫn lợi ích, định dạng câu hỏi, số cụ thể, từ khóa trước). Mỗi ứng viên được gắn cờ tuân thủ độ dài.
  • explain_seo_terms(category) — bảng thuật ngữ tham khảo của hơn 40 thuật ngữ SEO và AEO: SEO, AEO, GEO, JSON-LD, FAQPage, canonical, llms.txt, Core Web Vitals, E-E-A-T, cập nhật nội dung hữu ích, trang doorway, và hơn thế nữa. Lọc theo danh mục: cơ bản, AEO, kỹ thuật, phân tích, phạt.

Cài đặt

  • install_skill(agent) — trả về các lệnh cài đặt cho Kỹ năng ranki-seo-skills trên Claude Code, Claude Desktop, Cursor, Windsurf, Dự án web Claude.ai và các agent AGENTS.md chung.

Tài khoản Ranki.io của bạn — dữ liệu xếp hạng thực bên trong IDE của bạn (khóa API trả phí)

  • get_account() — whoami cho khóa API của bạn: tên, email, gói, giới hạn hàng ngày và hàng tháng, mức sử dụng hiện tại.
  • list_projects() — liệt kê các dự án trong tài khoản Ranki.io của bạn.
  • list_articles(project_id) — chỉ mục phân trang của các bài viết trong một dự án: nano_id, tiêu đề, trạng thái, ngôn ngữ, focus_keyword[], dàn ý TOC, số từ, điểm SEO. Bộ lọc trạng thái tùy chọn.
  • get_article(article_id) — lấy một bài viết duy nhất bằng nano_id của nó: tiêu đề, HTML, từ khóa trọng tâm, mục lục, URL hình ảnh nhúng, điểm SEO.
  • list_rank_tracking(project_id) — tóm tắt Google Search Console cho một dự án: tổng 28 ngày, 20 từ khóa hàng đầu theo nhấp chuột, 20 từ khóa cơ hội hàng đầu (vị trí > 10 với hiển thị — những chiến thắng dễ dàng).
  • list_gsc_keywords(project_id) — danh sách từ khóa GSC phân trang đầy đủ, có thể sắp xếp theo nhấp chuột / hiển thị / vị trí / CTR.
  • ai_visibility(project_id) — ảnh chụp trích dẫn AI đã ghi: chủ đề được theo dõi nào của bạn đã xuất hiện trong ChatGPT, Claude, Perplexity và Google AI Overview SERPs tại thời điểm chụp.

Một phiên làm việc điển hình trông như thế nào

You:    audit my site speed and fix the slow images

Claude: → Calling ranki.audit_speed(url="https://myapp.dev")
        ← Lighthouse: 42 perf · LCP 4.8s · 3 images blocking the paint.
        → Calling ranki.optimize_images([hero.png, banner.jpg, card.png])…
        ← 3 files, recipes returned.
        → Running sharp-cli to convert hero.png → hero.avif + hero.webp + hero@2x.avif…
        → Editing app/page.tsx — rewriting <img> as <picture srcset>, adding alt text…
        → Calling ranki.audit_speed again to verify…
        ← Lighthouse: 96 perf · LCP 1.4s.

You:    now find pages that shouldn't be in Google

Claude: → Calling ranki.audit_hidden_pages(domain="https://myapp.dev")
        ← 8 robots-disallow, 12 noindex, 118 keep, 4 unsure.
        → Editing public/robots.txt to disallow /admin /dashboard /checkout /account…
        → Adding <meta name="robots" content="noindex"> to app/search/page.tsx…
        Done. Submit URL-removal requests in Search Console for the 8 admin pages.

Tệp Kỹ năng (trong ranki-seo-skills) cho agent của bạn biết khi nào gọi công cụ nào, theo thứ tự nào, và ở đâu trong repo của bạn để áp dụng mỗi sửa chữa.

Giới hạn tốc độ

BậcGiới hạn hàng ngàyPhạm viCông cụ có sẵn
Không khóa5 lần gọimỗi IP15 công cụ miễn phí (kiểm tra, tạo, tốc độ, tối ưu hình ảnh, chiến lược nội dung, cài đặt)
Khóa API Ranki.io500 lần gọimỗi khóaTất cả 22 công cụ, bao gồm 7 công cụ cầu nối đọc từ khóa GSC thực, theo dõi xếp hạng, trích dẫn AI, danh sách dự án và thư viện bài viết từ tài khoản Ranki.io của bạn

Nhận khóa tại app.ranki.io/developer. X-RateLimit-Limit, X-RateLimit-RemainingX-RateLimit-Reset được trả về trên mỗi phản hồi. Thông báo lỗi của bộ điều phối bao gồm đếm ngược đặt lại và đường dẫn nâng cấp.


Cài đặt

Claude Desktop / Claude Code (khuyến nghị cho hầu hết vibe-coder)

Thêm vào ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "ranki": {
      "command": "npx",
      "args": ["-y", "@ranki.io/mcp"],
      "env": { "RANKI_API_KEY": "rk_live_..." }
    }
  }
}

Khởi động lại Claude Desktop. Chỉ báo MCP sẽ hiển thị ranki với 22 công cụ.

Cursor (vận chuyển HTTP, không cần npx)

.cursor/mcp.json trong dự án của bạn:

{
  "mcpServers": {
    "ranki": {
      "url": "https://mcp.ranki.io",
      "headers": { "X-API-Key": "rk_live_..." }
    }
  }
}

ChatGPT Desktop, Continue.dev, Zed, bất cứ thứ gì có khả năng MCP

Nếu máy khách hỗ trợ stdio MCP, sử dụng đoạn mã Claude Desktop. Nếu nó hỗ trợ HTTP MCP, sử dụng đoạn mã Cursor.

Nhận khóa API miễn phí của bạn

Truy cập app.ranki.io/developer và nhấp Tiết lộ. Khóa của bạn đã tồn tại — mỗi tài khoản Ranki.io được tự động tạo một khóa. Công cụ tư vấn miễn phí hoạt động không cần khóa (5 lần gọi/IP/ngày); các công cụ cầu nối list_projectsget_article yêu cầu một khóa.


Cách vibe-coder sử dụng nó

Tình huống 1: "Tôi vừa xuất xưởng một trang web, tôi phải làm gì?"

You: I just shipped my Next.js app at https://myapp.com. What SEO do I need?

Claude (via Ranki MCP):
  → Calling seo_starter_kit(domain="myapp.com")
  ← [Returns robots.txt + sitemap.xml + llms.txt + JSON-LD templates]
  → Writing public/robots.txt
  → Writing public/sitemap.xml (enumerating pages from app/ directory…)
  → Writing public/llms.txt
  → Adding JSON-LD <script> to app/layout.tsx
  → Calling audit_seo to verify…
  ← Score: 92/100. 🎉

Tình huống 2: "Tại sao ChatGPT không trích dẫn tài liệu của tôi?"

You: Why doesn't ChatGPT cite my docs site?

Claude (via Ranki MCP):
  → Calling audit_aeo(url="https://docs.myproduct.com")
  ← Score 38/100. Failing: no FAQPage schema, no llms.txt, robots.txt blocks ClaudeBot.
  → Fixing each failure in your repo…
  ← Score 88/100. Re-deploy and ChatGPT should pick it up within 7-14 days.

Tình huống 3: "Tôi không biết viết bài blog nào"

You: I have a Stripe alternative landing page but the blog is empty. Help.

Claude (via Ranki MCP):
  → Calling find_topic_ideas(url="https://mystripe-alt.com")
  ← [Returns brief with topic generation methodology + 15-topic structure]
  → [Generates 15 topics organized by intent, picks top 3]
  ← Recommended first 3 articles:
     1. "How to switch payment processors without losing customers" (transactional)
     2. "Stripe vs us: side-by-side fee comparison for $10K/mo MRR" (commercial)
     3. "What is interchange-plus pricing and why most SaaSes overpay" (informational)

Tình huống 4: "Tôi đang thiếu từ khóa khoảng trống nào?"

You: My competitors are stripe.com and lemonsqueezy.com. What am I missing?

Claude (via Ranki MCP):
  → Calling find_keyword_gap(url="https://mystripe-alt.com",
                              competitors=["stripe.com","lemonsqueezy.com"])
  ← [Returns methodology + per-competitor analysis steps]
  → Crawling /blog on both competitors…
  → Cross-referencing against your sitemap…
  ← 5 high-value gaps found:
     - "PCI compliance for small SaaS" (covered by Stripe, not you)
     - "How to handle subscription dunning" (covered by both, not you)
     - … 3 more

Kiến trúc

┌────────────────────────┐         ┌──────────────────────────┐
│  Claude / Cursor / etc │         │  mcp.ranki.io (PHP)      │
│                        │         │                          │
│  1. Sees 22 tools      │ JSON-RPC│  - 22 tool definitions   │
│  2. Decides to use one ├────────►│  - HTTP + stdio (npx)    │
│  3. Receives advice    │         │  - 5/IP or 500/key per   │
│  4. Acts on the repo   │         │    UTC day rate limit    │
│                        │         │  - REST API bridge       │
└────────────────────────┘         └────────────┬─────────────┘
                                                │ (only for keyed tools)
                                                ▼
                                   ┌──────────────────────────┐
                                   │  app.ranki.io REST API   │
                                   │  /api/v1/projects        │
                                   │  /api/v1/articles/...    │
                                   └──────────────────────────┘

Hai phương thức vận chuyển

  • stdio (Claude Desktop, Claude Code, hầu hết máy khách MCP) — cài đặt gói npm @ranki.io/mcp, là một shim Node.js 50 dòng ủy quyền stdio JSON-RPC tới https://mcp.ranki.io.
  • HTTP (Cursor, máy khách tùy chỉnh) — trỏ trực tiếp tới https://mcp.ranki.io. Không cần cài đặt Node.

Bố cục kho lưu trữ

ranki-mcp/
├── server/                     # PHP MCP server (deployed to mcp.ranki.io)
│   ├── public/index.php        #   GET → marketing landing page (HTML)
│   ├── index.php               #   POST → JSON-RPC 2.0 dispatcher
│   ├── lib/
│   │   ├── jsonrpc.php         #   JSON-RPC reply helpers
│   │   ├── registry.php        #   Tool registry + REST API bridge
│   │   └── ratelimit.php       #   Per-IP rate limit (5/day for free tier)
│   └── tools/
│       ├── seo_starter_kit.php
│       ├── find_topic_ideas.php
│       ├── find_keyword_gap.php
│       ├── audit_aeo.php
│       ├── audit_seo.php
│       ├── generate_sitemap_xml.php
│       ├── generate_llms_txt.php
│       ├── generate_robots_txt.php
│       ├── list_projects.php
│       └── get_article.php
└── npx/                        # Node.js stdio shim (published as @ranki.io/mcp)
    ├── package.json
    ├── index.js                #   ~50 lines: stdin→POST→stdout
    └── README.md

SEO vs AEO — sự khác biệt là gì?

SEO (Tối ưu hóa Công cụ Tìm kiếm) là làm cho trang web của bạn xếp hạng trong 10 liên kết xanh cổ điển trên Google. Các tín hiệu: thẻ tiêu đề, mô tả meta, H1, canonicals, sơ đồ trang web, liên kết nội bộ, tốc độ trang, thân thiện di động, HTTPS. Các công cụ như Ahrefs / SEMrush / SurferSEO chấm điểm những điều này.

AEO (Tối ưu hóa Công cụ Trả lời) là làm cho trang web của bạn được trích dẫn khi ChatGPT, Claude, Perplexity, hoặc Google AI Overviews trả lời câu hỏi của người dùng. Các tín hiệu khác nhau:

  • FAQPage JSON-LD — tín hiệu trích dẫn lớn nhất.
  • Giới thiệu định nghĩa — đoạn đầu tiên là câu trả lời súc tích "X là …".
  • Dòng tác giả + E-E-A-T — LLMs thích nguồn được trích dẫn có tác giả được nêu tên.
  • llms.txt — lời mời rõ ràng cho LLMs sử dụng nội dung của bạn.
  • robots.txt cho phép bot AI — GPTBot / ClaudeBot / PerplexityBot KHÔNG được bị chặn.
  • Tiêu đề kiểu trả lời — H2/H3 được diễn đạt như câu hỏi ("X là gì?", "X hoạt động như thế nào?").
  • Bảng so sánh — phần tử HTML được trích dẫn cao nhất trong AI Overviews.

audit_aeo kiểm tra tất cả 8 điều này và cho AI của bạn biết chính xác cần sửa gì. Tính đến năm 2026, lưu lượng AEO là kênh SEO phát triển nhanh nhất và hầu hết các trang web không có phạm vi bao phủ.


llms.txt — tiêu chuẩn tìm kiếm AI mới nổi

Lấy cảm hứng từ robots.txt nhưng dành cho LLMs. Một tệp Markdown tại /llms.txt cho trình thu thập AI biết:

  • Trang web của bạn nói về điều gì (bằng tiếng Anh đơn giản, không phải siêu dữ liệu).
  • Trang nào quan trọng nhất.
  • Cách trích dẫn bạn.
# Acme Corp

> Acme makes the SDK for shipping React Native apps faster.

## Key pages

- [Homepage](https://acme.dev/)
- [Documentation](https://acme.dev/docs)
- [Pricing](https://acme.dev/pricing)
- [Blog](https://acme.dev/blog)

## About

- Founded 2024, based in Berlin.
- Used by 12,000+ teams including Linear and Notion.
- Open source SDK on github.com/acme/sdk.

Sử dụng generate_llms_txt để tạo một cái trong 5 giây.


Tự lưu trữ

Máy chủ MCP là PHP 8.4 thuần túy — không framework, không cơ sở dữ liệu, không phụ thuộc Composer. Thả thư mục server/ sau một vhost Nginx phục vụ public/index.php và bạn đã xong.

server {
  server_name mcp.yourdomain.com;
  root /var/www/ranki-mcp/server/public;
  index index.php;
  location / {
    try_files $uri $uri/ /index.php?$query_string;
  }
  location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.4-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
  }
}

lib/ratelimit.php sử dụng các tệp trong /tmp/ để giới hạn tốc độ IP — hoạt động ngay lập tức. Để giới hạn tốc độ được hỗ trợ bởi Redis ở quy mô lớn, hoán đổi cách triển khai.


Đóng góp

PR được chào đón cho các công cụ tư vấn mới. Để thêm một công cụ:

  1. Tạo server/tools/your_tool.php trả về một function (array $args, string $apiKey): array có thể gọi.
  2. Trả về rk_mcp_text_content("...your structured advice...").
  3. Đăng ký công cụ trong server/lib/registry.php dưới rk_mcp_tool_definitions().

Đặt tên công cụ: <verb>_<noun> snake_case (ví dụ: audit_aeo, find_topic_ideas).

Triết lý công cụ: trả về dữ liệu + hướng dẫn cho AI gọi, không bao giờ tự gọi LLM.


Câu hỏi thường gặp

Cái này có tốn tiền không?

Các công cụ tư vấn (mọi thứ trừ list_projects / get_article) là miễn phí — 5 lần gọi mỗi IP mỗi ngày UTC. Để xóa giới hạn đó, nhận khóa API miễn phí tại app.ranki.io/developer. Các công cụ cầu nối yêu cầu khóa vì chúng kéo dữ liệu Ranki.io riêng tư của bạn.

Ranki MCP có sử dụng tín dụng Claude của tôi không?

Có — và chỉ của bạn. Chúng tôi không bao giờ thực hiện cuộc gọi LLM. Máy chủ MCP trả về lời khuyên có cấu trúc; Claude / Cursor của bạn đánh giá và hành động dựa trên nó bằng tín dụng của chính bạn.

Dữ liệu chảy đi đâu?

  • Các công cụ tư vấn (audit_*, generate_*, seo_starter_kit, find_*) tải URL bạn truyền (không có cuộc gọi mạng nào khác).
  • Các công cụ cầu nối (list_projects, get_article) gọi app.ranki.io/api/v1/... qua HTTPS với X-API-Key của bạn.
  • Chúng tôi không ghi nhật ký nội dung yêu cầu. Chúng tôi ghi IP + tên công cụ + trạng thái phản hồi để giới hạn tốc độ + gỡ lỗi.

Nó có mã nguồn mở không?

Có — giấy phép MIT, mã nguồn đầy đủ trong repo này.

Tôi có thể chạy nó trong VPC của công ty tôi không?

Có — server/ là PHP thuần túy, không phụ thuộc dịch vụ bên ngoài ngoại trừ app.ranki.io cho các công cụ cầu nối (mà bạn có thể vô hiệu hóa bằng cách xóa các tệp công cụ đó).

Cái này khác gì với đối thủ cạnh tranh như Surfer / Frase / Outrank?

Đó là các bảng điều khiển SaaS kiểm tra từng URL một và đề xuất thay đổi. Ranki MCP là một lớp giao thức cho phép AI của bạn sử dụng các kiểm tra đó nội tuyến trong khi nó đang viết mã trong IDE của bạn. Hình dạng khác, mức giá khác (miễn phí), đối tượng khác (vibe-coder, không phải chuyên gia SEO).

Tôi là vibe-coder và tôi không biết AEO nghĩa là gì.

Đó chính là đối tượng mà cái này hướng đến. Bắt đầu với seo_starter_kit("yourdomain.com") — Claude của bạn sẽ hướng dẫn bạn mọi thứ.

Bạn sẽ huấn luyện AI trên dữ liệu của tôi chứ?

Chúng tôi không huấn luyện mô hình. Chúng tôi không có mô hình. Chúng tôi là một cố vấn mỏng trên các kiểm tra xác định.


Giấy phép

MIT. Xem LICENSE.

Được xây dựng cẩn thận bởi Ranki.io — Tự động hóa AI SEO + AEO cho người sáng lập, đại lý và người sáng tạo.