Keitaro TDS API MCP Plugin

by GodzillaDancer
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Uses environment variables for configuration, specifically for storing Keitaro API URL and API key.

  • Used for installation of the MCP server through repository cloning.

  • Provides JavaScript examples for interacting with the Keitaro TDS API, allowing users to manage campaigns, traffic streams, offers, and generate reports.

Keitaro TDS API MCP 플러그인

설명

Keitaro TDS API와 통합하기 위한 MCP 서버로, 캠페인, 스트림, 오퍼 및 기타 Keitaro 엔터티를 다루는 도구를 제공합니다.

설치

커서에 플러그인 설치

  1. 저장소를 복제합니다

지엑스피1

  1. 종속성 설치
npm install
  1. 패키지를 전역적으로 설치합니다.
npm install -g .
  1. 커서에 플러그인을 설치하세요
node install-cursor-plugin.js
  1. 커서 재시작

대안: 커서의 수동 구성

커서 구성에 Keitaro MCP 서버를 수동으로 추가할 수도 있습니다.

  1. 커서 MCP 구성 파일을 엽니다.
# On macOS open ~/.cursor/mcp.json # On Windows notepad %USERPROFILE%\.cursor\mcp.json # On Linux nano ~/.cursor/mcp.json
  1. "mcpServers" 개체에 다음 항목을 추가합니다.
"Keitaro": { "command": "mcp-keitaro-tds", "args": [] }
  1. 파일을 저장하고 커서를 다시 시작하세요.

API 키 구성

다음 매개변수를 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

KEITARO_API_URL=http://your-keitaro-domain.com/admin_api/v1 KEITARO_API_KEY=your-api-key

커서에서의 사용법

  1. 커서 실행
  2. 명령 팔레트를 엽니다(macOS에서는 Cmd+P, Windows/Linux에서는 Ctrl+P).
  3. "케이타로"를 찾아 선택하세요
  4. 이제 Cursor를 통해 Keitaro API를 사용할 수 있습니다.

사용 가능한 도구

캠페인

  • list_campaigns - 캠페인 목록을 가져옵니다
  • get_campaign - 특정 캠페인에 대한 정보를 가져옵니다.
  • create_campaign - 새 캠페인을 만듭니다
  • update_campaign - 기존 캠페인 업데이트
  • delete_campaign - 캠페인 삭제

트래픽 스트림

  • list_streams - 캠페인에 대한 트래픽 스트림 목록을 가져옵니다.
  • get_stream - 특정 스트림에 대한 정보를 가져옵니다

트래픽 소스

  • list_traffic_sources - 트래픽 소스 목록을 가져옵니다
  • get_traffic_source - 특정 트래픽 소스에 대한 정보를 가져옵니다.

제안

  • list_offers - 제안 목록 가져오기
  • get_offer - 특정 제안에 대한 정보를 가져옵니다

클릭 및 전환

  • list_clicks - 클릭 목록 가져오기
  • get_click - 특정 클릭에 대한 정보를 가져옵니다
  • list_conversions - 변환 목록을 가져옵니다
  • get_conversion - 특정 변환에 대한 정보를 가져옵니다.

보고서

  • get_report - 지정된 매개변수로 보고서 생성

도메인

  • list_domains - 도메인 목록을 가져옵니다
  • get_domain - 특정 도메인에 대한 정보를 가져옵니다

사용 예

캠페인 목록 가져오기

list_campaigns({ limit: 10, page: 1, search: "search query" })

새 캠페인 만들기

create_campaign({ name: "New Campaign", type: "position", cost_type: "CPC", cost_value: 1.5, group_id: 1, state: "active", traffic_source_id: 1 })

보고서 받기

get_report({ from: "2025-01-01", to: "2025-01-31", group: "campaign", filters: { campaign_id: 123 } })

개발

개발 모드에서 실행 중

npm run dev

MCP 서버 테스트

npm run inspect

Appeared in Searches

ID: iy1fgw1o6g