MCP & ChatGPT app

AutoPSEO chạy một máy chủ MCP (Model Context Protocol) duy nhất tại https://app.autopseo.com/mcp. Bất kỳ trợ lý nào hỗ trợ MCP qua HTTP đều có thể kết nối, hoặc bằng cách đăng nhập vào tài khoản AutoPSEO của bạn, hoặc bằng API key apk_live_, rồi làm việc với cùng các property, quyền hạn và gói dịch vụ như bạn. Máy chủ đăng ký 72 công cụ chia thành ba nhóm: báo cáo Search Console và GA4, dữ liệu nghiên cứu, và content engine, qua đó AI của riêng bạn có thể viết bài cho website của bạn.

Kết nối bằng đăng nhập

Các công cụ hỗ trợ đăng nhập MCP không cần key. Hãy thêm địa chỉ, đăng nhập vào AutoPSEO khi công cụ yêu cầu rồi phê duyệt; sau đó công cụ sẽ tự giữ và tự gia hạn quyền truy cập của mình.

• Claude Code: chạy claude mcp add --transport http autopseo https://app.autopseo.com/mcp, sau đó gõ /mcp, chọn autopseo và chọn Authenticate.
• Claude trên web hoặc desktop: Settings → Connectors → Add custom connector, dán https://app.autopseo.com/mcp, rồi chọn Connect và đăng nhập.
• Cursor: thêm máy chủ vào ~/.cursor/mcp.json (mọi dự án) hoặc .cursor/mcp.json (một dự án), rồi dùng nút Connect mà Cursor hiển thị bên cạnh.

{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

Mỗi công cụ được kết nối theo cách này sẽ xuất hiện trong mục Signed-in tools trên trang MCP & API, nơi Sign out sẽ ngắt kết nối của công cụ đó ngay lập tức. Một yêu cầu đầu tiên phù hợp là "List the Search Console properties on my account": câu trả lời chứng minh kết nối hoạt động và cho trợ lý biết chính xác tên các property mà những công cụ khác yêu cầu.

ChatGPT

ChatGPT kết nối thông qua chế độ nhà phát triển (developer mode), và trang MCP & API hướng dẫn từng bước trong mục ChatGPT app. Tóm tắt: trong ChatGPT, mở Settings → Apps & Connectors → Advanced settings và bật Developer mode (ứng dụng liệt kê các gói ChatGPT Plus, Pro, Business, Enterprise và Edu), chọn Create, đặt tên cho connector, đặt URL máy chủ MCP là https://app.autopseo.com/mcp và phương thức xác thực là OAuth, rồi đăng nhập vào AutoPSEO khi ChatGPT yêu cầu. Connector của ChatGPT chỉ hỗ trợ OAuth hoặc không xác thực, nên API key không dùng được ở đây. Xem thêm tại trang ChatGPT.

Kết nối bằng API key

Key dành cho script, tác vụ theo lịch và các máy không có trình duyệt. Tại MCP & API → API keys, hãy đặt tên cho key và chọn phạm vi của nó:

• Read only: truy vấn dữ liệu và chạy báo cáo; không thể thêm, sửa hay xóa bất cứ thứ gì.
• Read & write: mọi thứ mà key chỉ đọc làm được, cộng thêm các công cụ thay đổi dữ liệu hoặc tiêu tốn credit nghiên cứu.

Key đầy đủ, gồm apk_live_ theo sau là 32 ký tự hex, chỉ hiển thị một lần; AutoPSEO chỉ lưu mã băm SHA-256 của nó. Danh sách key cho biết thời điểm tạo từng key, lần dùng gần nhất và số yêu cầu đã gửi, còn Revoke sẽ vô hiệu hóa key ngay lập tức. Bạn có thể có tối đa 25 key đang hoạt động. Gửi key dưới dạng Authorization: Bearer apk_live_... (header x-api-key cũng dùng được):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

Trang này còn có các đoạn mã mẫu cho OpenAI Responses API, JSON-RPC thuần với curl (máy chủ dùng Streamable HTTP transport), và REST API tại https://app.autopseo.com/v1, cung cấp 19 công cụ Search Console và GA4 với cùng các key và một tài liệu OpenAPI 3.1 tại /v1/openapi.json.

Các công cụ

Trang MCP & API luôn liệt kê tên các công cụ hiện tại; tại thời điểm viết trang này có 72 công cụ.

Search Console và GA4 (19 công cụ)

list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown và ga4_key_events. Các công cụ này không tốn credit. Nếu không chỉ định ngày, chúng bao quát 28 ngày đã ổn định gần nhất so với 28 ngày trước đó, và ai cũng có thể dùng thử trên property demo sc-domain:demo.autopseo.app. Dù tên gọi có vẻ khác, content_decay thuộc nhóm này: nó tìm các trang đang mất lượt nhấp.

Nghiên cứu (33 công cụ)

• Tài khoản và dự án: whoami, create_project, get_project_context, update_project_context
• Từ khóa: research_keywords, get_keyword_metrics, get_ranked_keywords, get_domain_keyword_suggestions, save_keywords, list_saved_keywords
• Tên miền, trang kết quả và liên kết: get_domain_overview, get_serp_results, find_serp_competitors, get_backlinks_overview, get_backlinks_profile
• Theo dõi thứ hạng: create_rank_tracker, get_rank_tracker, add_rank_tracking_keywords, remove_rank_tracking_keywords, estimate_rank_tracker_cost, run_rank_tracker
• Tìm kiếm cục bộ: search_local_businesses, get_local_serp_results, get_local_rank_grid, get_business_profile, get_business_reviews, get_business_updates, get_google_business_questions, list_business_categories
• Kiểm tra website: run_site_audit, get_audit_status, get_audit_issues, get_audit_pages

Nhiều công cụ trong số này mua dữ liệu từ DataForSEO và trừ vào credit nghiên cứu của bạn, vì vậy hãy giữ yêu cầu tập trung và kiểm tra trước khi chạy các lô lớn.

Content engine (20 công cụ)

Các công cụ này cho phép AI của riêng bạn làm việc qua cùng hàng đợi với trình viết bài của AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value và content_remove_path. Máy chủ cũng cung cấp năm prompt: write-articles, optimize-page, revise-draft, connect-repo và refresh-decayed.

Một phiên làm việc điển hình là liệt kê các tác vụ, nhận một tác vụ (việc nhận sẽ giữ tác vụ đó trong hai giờ), đọc brief, viết bài, gửi bài và sửa mọi lỗi mà các bước kiểm tra trả về, rồi chỉ xuất bản khi bạn yêu cầu. Ảnh bìa và bản dịch có công cụ riêng. Các bài viết theo cách này vượt qua cùng các bước kiểm tra như bài của chính AutoPSEO và không tốn hạn mức bài viết của bạn, tuy nhiên lần gọi đầu tiên để lấy một brief sẽ đọc kết quả tìm kiếm trực tiếp và tốn credit nghiên cứu. Toàn bộ quy trình có trong Viết bài bằng AI của riêng bạn.

Công cụ đọc, ghi và trả phí

Mỗi công cụ thuộc một nhóm quyền truy cập. Công cụ Read chỉ xem (33 công cụ), công cụ write thay đổi không gian làm việc của bạn (22), và công cụ paid chỉ đọc nhưng mua dữ liệu nghiên cứu (17). Key chỉ đọc chỉ có thể gọi các công cụ read. Thành viên nhóm có quyền Read cũng chỉ gọi được công cụ read, dù dùng key hay đăng nhập nào, và mỗi thành viên chỉ truy cập được các property có trong lời mời của họ (Chia sẻ & quyền truy cập của nhóm).

Giới hạn và lỗi

Số lệnh gọi bị giới hạn ở mức 60 mỗi phút cho mỗi key và 1,000 mỗi giờ cho mỗi tài khoản, tính trên tất cả các key của tài khoản đó. Khi vượt một trong hai giới hạn, máy chủ trả về HTTP 429 kèm header Retry-After, và hầu hết các client sẽ tự chờ rồi thử lại; các bước bắt tay initialize và ping không được tính. Khi bản dùng thử kết thúc mà chưa đăng ký gói, các công cụ sẽ trả lời "subscription required". Nhà cung cấp của trợ lý chỉ nhận dữ liệu của bạn cho những yêu cầu bạn thực hiện; hãy đăng xuất công cụ hoặc thu hồi key của nó để dừng việc này. Có thêm ví dụ tại trang Search Console MCP.