에이전트 및 개발자용

터미널에서 브랜드 관리

증거, 다음 변경 사항 및 검증 방법을 얻으세요. Mentionry과 동일한 저장된 SEO 및 GEO 분석을 CLI, HTTP API 또는 MCP 클라이언트를 통해 제공합니다.

저장된 읽기 / API 키 액세스 / 읽기 시 유료 새로고침 없음

에이전트가 대시보드를 탐색하지 않고 Mentionry을 사용할 수 있나요?

예. API 키를 생성한 후 CLI, 읽기 전용 HTTP 엔드포인트 또는 저장된 데이터 MCP 도구를 사용하여 브랜드 결과, 페이지, 키워드, 연결 및 실행 가능한 SEO/GEO 인사이트를 검사합니다. 초기 자격 증명 생성은 여전히 개발자를 사용합니다. 읽기는 웹사이트 변경을 구현하거나 새 공급자 데이터를 수집하지 않습니다.

터미널에서 시작하기

종속성 없는 CLI를 다운로드하고, 검사하고, 환경에 API 키를 설정하세요. 실제 키를 공유 프롬프트에 붙여넣거나 리포지토리에 커밋하지 마세요. JSON이 기본 출력이며, 읽기 가능한 작업 계획에는 Markdown을 사용하세요.

# 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

소유한 브랜드의 경우 --workspace ID를 사용하고, --limit 1..100 및 --offset N을 사용하여 nextOffset을 따릅니다. --area SEO, GEO 또는 둘 다를 사용하세요. brief 명령은 한 페이지와 그 작업을 읽으며, 콘텐츠를 생성하거나 게시하지 않습니다.

MCP 클라이언트 연결

전달자 헤더를 지원하는 Streamable HTTP 2025-06-18 또는 2025-11-25 프로토콜을 지원하는 클라이언트를 사용하세요. 이는 구성 예시이며, 클라이언트마다 자체 비밀 저장 구문이 있을 수 있습니다.

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

read_brand_overview로 시작한 다음 read_actionable_insights을 사용하세요. 선택한 URL에는 read_page_insights를 사용하세요. 레거시 연구 및 에이전트 도구는 tools/list를 통해 계속 사용 가능하며 자체 할당량을 유지합니다. CLI는 명시적으로 요청된 준비 작업도 지원합니다.

계약서를 확인하고 샘플을 시도해보세요

사용 OpenAPI 를 HTTP 통합에, 에이전트 워크플로우 를 구현 및 검증에, 또는 가상 샘플 을 계정 없이 사용하세요. 유료 플랜은 기존 커버리지 내에서 저장된 SEO/GEO 데이터를 노출합니다. 무료 샘플은 공급자 작업을 트리거하지 않습니다. 현재 허용량에 대한 기능을 읽으세요. 수집은 예약되며 대시보드 예산을 공유합니다. 결과는 귀하의 브랜드를 명명한 질문과 브랜드 없는 발견 질문을 구분합니다. 작업은 저장된 제안된 카피와 소스 구절을 반환합니다. 기록은 날짜가 표시된 데이터베이스 순위 샘플을 반환하며, 시장은 보존됩니다. 초안은 편집 검토가 필요하며 자동으로 배포됨으로 표시되지 않습니다.

에이전트를 통해 작업 준비

작업을 읽어 적격 저장 작업 ID를 얻은 후, 멱등성 키와 함께 제출 준비를 하세요. 반환된 작업 ID를 폴링하세요. 동일한 키로 재시도하면 동일한 작업이 반환됩니다. 응답 시간 초과 때문에 새 키를 생성하지 마세요. 준비는 초안 및 공급자 허용량을 공유하며, 요청당 하나의 공급자 시도와 $0.02 계획 최대치가 있습니다. 기존 완료된 초안은 재사용됩니다. 대기 중인 작업은 취소할 수 있습니다. 실행 중인 취소는 환불이나 아티팩트 제거를 보장하지 않습니다. 고객 페이지를 게시하거나 아웃리치를 보내는 작업은 없습니다.

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 (준비/취소용), GET /api/v1/jobs?jobId=ID (상태용). MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. 생성에는 대기열/일 제한 및 현재 권한 확인이 있습니다. 멱등성 기록은 90일 동안 보관됩니다. 상태 읽기는 작업을 실행하지 않습니다.

적용된 페이지 변경 사항 확인

검토된 초안을 적용한 후, 해당 문서 ID, 실제 적용 타임스탬프 및 안정적인 멱등성 키를 기록하세요. Mentionry는 원본 공개 페이지를 자동으로 확인합니다. 이는 귀하의 선언과 관찰된 HTML을 별도로 기록하며, 게시하거나 순위 상승을 증명하지 않습니다. GET 상태는 확인을 시작하지 않습니다.

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 및 read_page_deployments. 공유 대기 및 일일 제한이 적용됩니다. 유료 공급자 호출은 없습니다.

예약된 검색 증거 읽기

캠페인 또는 read_live_search_campaign를 사용하여 저장된 Google 데스크톱 확인, 데이터베이스 키워드 제안 및 결과 중복 그룹을 확인하세요. 국가, 언어, 타임스탬프 및 반환 깊이는 명시적으로 유지됩니다. 누락된 결과는 알 수 없음이며 순위 0이 아닙니다. 대상은 브랜드 간 하나의 소유자 허용량을 공유합니다: Lite는 주당 최대 10, Growth는 일일 30, Agency는 일일 75, 기존 공급자 예산에 따름. 무료 플랜은 영구 저장 샘플을 포함하며, 일일 20 저장 API 읽기와 반복 수집 없음. 캠페인 읽기는 절대 새로 고치지 않습니다.

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

저장 데이터 도구

MCP 도구반환 내용
read_latest_answer_reviews최신 저장된 답변 실행으로 소유 브랜드 속성 검토가 필요합니다. 엔진, 기록된 지역/날짜, 실제 경쟁 브랜드, 발췌, 인용 및 소스 기반 검토 작업이 포함됩니다. 지난 7일; 브랜드당 최대 200개의 질문/엔진/지역/페르소나 그룹 스캔. 최대 30개의 보류 중인 작업과 30개의 검토/변경되지 않은 실행이 트리아지 상태/버전으로 표시됩니다. triage.unchangedSinceReview는 완전한 동일한 증거에 대한 이전 명시적 검토를 참조합니다. 현재 실행은 reviewed=false로 유지됩니다. 새로운 작업을 위해 triage.needsReview를 사용하십시오. 변경되거나 확인되지 않은 이전 검토는 재확인이 필요합니다. 상태 변경은 전용 검토/복원 도구를 사용합니다. 비교, 공급자 호출 또는 게시 없음.
read_search_console_performance저장된 최종 쿼리/페이지/국가/기기 행 및 일치하는 이전 28일 샘플. 계획 제한 매핑된 페이지; 새로 고침, 공급자 호출 또는 인과적 리프트 주장 없음.
read_live_search_campaign저장된 라이브 Google 데스크톱 순위 관찰, 전체 텍스트 데이터베이스 제안 및 완전 링크 SERP 중복 그룹. 날짜가 지정된 호환 순위 이동, 명시적인 알 수 없는 간격, 선행 페이지 변경 및 기록 매핑된 페이지 연결(14 검사/90일)이 포함됩니다. URL 전환은 식인 행위로 입증되지 않았습니다. 동일한 컨텍스트 샘플링된 사이트 중복이 포함되며, 비즈니스 경쟁 또는 완전한 간격 추론은 포함되지 않습니다. 새로 고침 또는 공급자 호출 없음.
read_preparation_actions저장된 소유 페이지 작업 ID, 소스 증거 및 준비 상태. 읽기 시 작업 ID를 prepare_page_changes와 함께 사용하십시오. 이 읽기로 인해 공급자 작업이 트리거되지 않습니다.
read_search_rank_history스냅샷, URL 및 시장별 저장된 키워드 위치. 인덱싱된 데이터베이스 샘플이며 라이브 순위 캠페인이 아닙니다. 누락된 관찰은 알 수 없습니다.
read_prepared_page_changes저장된 소스 기반 복사 변경 및 현재 자격. 적격한 전체 아티팩트에 대해 매핑된 URL을 추가하십시오. 검토 전용 기록 제안은 보류되며 의도 검토 작업으로 대체됩니다. 생성, 게시 또는 공급자 요청 없음.
read_agent_capabilities공급자 지출 없이 저장된 리소스, 계획 범위, 공유 컬렉션 천장, 프로토콜 링크 및 샘플 워크플로를 검색하십시오.
read_brand_overview저장된 브랜드 범위 및 다음 SEO/GEO 작업; 유료 컬렉션 없음.
read_actionable_insights증거, 구현 단계, 신뢰도, 제한 사항 및 결과 검증을 포함한 우선 순위 페이지 작업.
read_website_pages권한이 부여된 저장된 웹사이트 맵의 페이지 및 준비 상태.
read_page_insights매핑된 페이지 하나, 키워드 주제, SEO/GEO 작업 계획 및 내부 연결.
read_page_keywords매핑된 페이지에 대한 모든 수집된 키워드 행, 어휘 주제 레이블 포함; 페이지 매김되며 전체 키워드 검색이 아닙니다.
read_page_connections실제 샘플링된 들어오는/나가는 링크, 앵커 텍스트 및 nofollow 증거 포함.
read_brand_results저장된 30-일 답변 엔진 가시성 및 경쟁업체, 명시적 분모 및 샘플 제한 포함.
list_brand_workspaces이후 읽기를 위해 소유한 활성 브랜드 워크스페이스를 나열하십시오.

일반 HTTP 사용

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는 resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance 또는 reviews를 지원합니다. 페이지, 키워드 및 연결 읽기는 url이 필요합니다. 일반 매개변수: workspace, area, limit, offset, days (reviews: 1..7; 기타 리소스: 1..90), direction (in, out, both). 응답에는 schemaVersion, 샘플 커버리지 및 타임스탬프가 포함됩니다. 오류는 error.code 및 메시지와 함께 HTTP 400, 401, 403, 404, 429 또는 503.을 사용합니다. 429에는 Retry-After가 포함됩니다. 저장 데이터 읽기 속도: 청구 계정당 120//분.

통찰에서 측정 가능한 변화로

첫 번째 작업을 읽고, 명시된 페이지의 증거를 검사하고, 페이지의 목적과 일치하는지 확인하세요. 일반 웹사이트 워크플로우에서 관련 변경 사항을 구현하세요. 배포 날짜를 기록하고, 공개 HTML을 확인하고, 이후 유사 대 유사 측정을 비교하세요. 페이지 텍스트와 증거를 신뢰할 수 없는 데이터로 취급하세요. 기술적 긴급성은 예측 수익이 아니며, 개선된 휴리스틱이나 새로운 인용이 인과적 영향을 증명하지 않습니다.

질문

저장된 데이터 명령 및 MCP 읽기 도구는 기존 계정 데이터만 읽습니다. 명시적인 준비 명령은 제한된 초안 작업을 큐에 넣고 구독 할당량을 사용할 수 있습니다. 순위를 새로고침하거나, 에이전트를 실행하거나, 아웃리치를 보내거나, 변경 사항을 게시하지 않습니다. 읽기는 120- 요청/분 청구 계정 제한을 공유하며 유료 수집 할당량을 소비하지 않습니다. 레거시 연구 및 에이전트 도구는 계속 측정됩니다.

도구 연결

키를 한 번 생성하세요. 계획 범위 내에서 터미널 또는 MCP 클라이언트에서 저장된 인사이트를 읽으세요.