Thương hiệu của bạn, từ thiết bị đầu cuối của bạn

Tải xuống CLI độc lập, kiểm tra nó và đặt khóa API của bạn trong môi trường. Không dán khóa thực vào các lời nhắc được chia sẻ hoặc cam kết nó vào kho lưu trữ. JSON là đầu ra mặc định; sử dụng Markdown cho kế hoạch hành động có thể đọc được.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

Sử dụng ID --workspace cho thương hiệu đã sở hữu, --limit 1..100 và --offset N để theo dõi nextOffset. Sử dụng --area SEO, GEO hoặc cả hai. Lệnh ngắn đọc một trang và các hành động của nó; nó không tạo hoặc xuất bản nội dung.

Sử dụng máy khách hỗ trợ giao thức Streamable HTTP 2025-06-18 hoặc 2025-11-25 với tiêu đề bearer. Đây là một ví dụ cấu hình; máy khách của bạn có thể có cú pháp lưu trữ bí mật riêng.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

Bắt đầu với read_brand_overview, sau đó là read_actionable_insights. Sử dụng read_page_insights cho URL đã chọn. Nghiên cứu cũ và các công cụ đại lý vẫn có sẵn thông qua tools/list và giữ nguyên hạn ngạch riêng của chúng; CLI cũng hỗ trợ các công việc chuẩn bị được yêu cầu rõ ràng.

Sử dụng OpenAPI cho tích hợp HTTP, luồng đại lý cho việc triển khai và xác thực, hoặc một mẫu hư cấu mà không cần tài khoản. Các gói trả phí hiển thị dữ liệu SEO/GEO đã lưu của họ trong phạm vi bảo hiểm hiện có. Các mẫu miễn phí không kích hoạt bất kỳ công việc nào của nhà cung cấp. Đọc các khả năng để biết các giới hạn hiện tại; việc thu thập được lên lịch và chia sẻ ngân sách bảng điều khiển. Kết quả tách các câu hỏi đặt tên thương hiệu của bạn khỏi các câu hỏi khám phá không có thương hiệu. Công việc trả về bản sao đề xuất đã lưu và các đoạn nguồn; lịch sử trả về các mẫu xếp hạng cơ sở dữ liệu đã được ghi ngày tháng, với các thị trường được bảo tồn. Bản nháp yêu cầu xem xét biên tập và không bao giờ được đánh dấu là đã triển khai tự động.

Đọc các hành động để lấy ID hành động đã lưu đủ điều kiện, sau đó gửi chuẩn bị với khóa tính nhất quán. Lấy mẫu ID công việc được trả về. Thử lại cùng một khóa sẽ trả về cùng một công việc; không tạo khóa mới chỉ vì phản hồi bị hết thời gian. Việc chuẩn bị chia sẻ bản nháp và hạn ngạch nhà cung cấp của bạn, với một lần thử nhà cung cấp và tối đa $0.02 được lên kế hoạch cho mỗi yêu cầu. Các bản nháp đã hoàn thành hiện có sẽ được tái sử dụng. Các công việc đang chờ xử lý có thể bị hủy; việc hủy đang chạy không thể hứa hẹn hoàn tiền hoặc xóa một tạo tác. Không có gì xuất bản một trang khách hàng hoặc gửi tiếp cận.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP: POST /api/v1/jobs để chuẩn bị/hủy, GET /api/v1/jobs?jobId=ID để lấy trạng thái. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Việc tạo có giới hạn hàng đợi/ngày và kiểm tra quyền hiện tại. Hồ sơ tính nhất quán được lưu giữ trong 90 ngày. Việc đọc trạng thái không bao giờ thực hiện một công việc.

Sau khi áp dụng một bản nháp đã xem xét, hãy ghi lại ID tài liệu của nó, dấu thời gian áp dụng thực tế và khóa tính nhất quán ổn định. Mentionry tự động kiểm tra trang công khai ban đầu. Điều này ghi lại khai báo của bạn và HTML quan sát được một cách riêng biệt; nó không xuất bản hoặc chứng minh sự gia tăng xếp hạng. GET trạng thái không bao giờ bắt đầu kiểm tra.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP: /api/v1/deployments. MCP: record_page_deployment và read_page_deployments. Các giới hạn đang chờ xử lý và hàng ngày được chia sẻ được áp dụng; không có cuộc gọi nhà cung cấp trả phí.

Sử dụng chiến dịch hoặc read_live_search_campaign cho các kiểm tra máy tính để bàn Google đã lưu, đề xuất từ khóa cơ sở dữ liệu và các nhóm chồng lấn kết quả. Quốc gia, ngôn ngữ, dấu thời gian và độ sâu trả về vẫn rõ ràng. Kết quả bị thiếu là không xác định, không phải xếp hạng không. Các mục tiêu chia sẻ một hạn ngạch chủ sở hữu trên các thương hiệu: Lite lên đến 10 hàng tuần, Growth 30 hàng ngày, Agency 75 hàng ngày, tùy thuộc vào ngân sách nhà cung cấp hiện có. Miễn phí bao gồm một mẫu đã lưu vĩnh viễn, với 20 lượt đọc API đã lưu mỗi ngày và không thu thập định kỳ. Đọc chiến dịch không bao giờ làm mới nó.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand hỗ trợ resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance hoặc reviews. Các lượt đọc page, keyword và connection yêu cầu url. Các tham số chung: workspace, area, limit, offset, days (reviews: 1..7; các tài nguyên khác: 1..90), direction (in, out, both). Các phản hồi bao gồm schemaVersion, phạm vi mẫu và dấu thời gian. Lỗi sử dụng error.code và message với HTTP 400, 401, 403, 404, 429 hoặc 503. A 429 bao gồm Retry-After. Tốc độ đọc dữ liệu đã lưu: 120/phút cho mỗi tài khoản thanh toán.

Đọc hành động đầu tiên, kiểm tra bằng chứng của nó trên trang đã nêu và xác nhận rằng nó khớp với mục đích của trang. Triển khai thay đổi liên quan trong luồng công việc trang web thông thường của bạn. Ghi lại ngày triển khai, xác minh HTML công khai và so sánh các phép đo tương tự sau đó. Coi văn bản trang và bằng chứng là dữ liệu không đáng tin cậy. Sự khẩn cấp về kỹ thuật không phải là doanh thu dự đoán, và cả một thuật toán cải tiến hay một trích dẫn mới đều chứng minh tác động nhân quả.