Developer & AI Gateway

GuinRank Unified Documentation

Choose your preferred pathway to integrate and connect with the GuinRank platform — either via direct REST API or via Model Context Protocol (MCP) for modern AI coding tools.

v7.1.7 Latest Release

50+ Available Endpoints

REST & MCP Standard JSON-RPC

4 Roles Full RBAC Control

REST / HTTP

Direct REST API Integration

Standard RESTful integration for backend servers, web apps, and mobile applications using HTTP and API Keys.

1. Generate an API Key from the dashboard (for Owner or Team Member).

2. Pass the key in the X-Api-Key request header and invoke the endpoint.

3. Receive JSON responses with accurate quota and credit tracking.

Explore Full API Reference

MCP Protocol

AI Agents & MCP Server

Connect Claude Desktop, Cursor IDE, and Antigravity directly to your GuinRank account for natural language SEO operations.

1. Add GuinRank MCP server configuration to your AI config file.

2. Provide your GUINRANK_API_KEY and base API URL.

3. Ask your AI agent to analyze keywords, extract competitors, or write articles.

Explore MCP Server Guide

Open Source

GRF — AI Record Format (Open Source)

A robust data serialization format designed to stop AI parser errors with zero dependencies, available on NPM and GitHub.

1. Eliminate JSON & CSV breaking bugs when AI models stream structured data.

2. Built-in tabular support using the ultra-safe broken bar (¦) separator.

3. Bidirectional converters: GRF ➔ JSON, JSON ➔ GRF, and GRF ➔ CSV.

Explore GRF Specification & Playground

Multi-Tier Role-Based Access Control (RBAC)

Owner

Owner: Full access to all tools, projects, articles, billing, and team management.

Manager

Manager: Manage team members, articles, tools, and generate member API keys.

Editor

Editor: Create and edit articles/projects within allocated quota and limits.

Viewer

Viewer: Read-only access to analyses and search results without edit rights.