Complemento MCP de la API TDS de Keitaro

Descripción

Servidor MCP para integración con la API TDS de Keitaro, que proporciona herramientas para trabajar con campañas, transmisiones, ofertas y otras entidades de Keitaro.

Instalación

Instalación del complemento en Cursor

Clonar el repositorio

git clone <repository-url>
cd mcp-keitaro-tds

Instalar dependencias

npm install

Instalar el paquete globalmente

npm install -g .

Instalar el complemento en Cursor

node install-cursor-plugin.js

Reiniciar cursor

Alternativa: Configuración manual en Cursor

También puedes agregar manualmente el servidor Keitaro MCP a tu configuración de Cursor:

Abra el archivo de configuración de Cursor MCP:

# On macOS
open ~/.cursor/mcp.json

# On Windows
notepad %USERPROFILE%\.cursor\mcp.json

# On Linux
nano ~/.cursor/mcp.json

Agregue la siguiente entrada al objeto "mcpServers":

"Keitaro": {
  "command": "mcp-keitaro-tds",
  "args": []
}

Guarde el archivo y reinicie Cursor

Configuración de la clave API

Cree un archivo .env en la raíz del proyecto con los siguientes parámetros:

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

Uso en Cursor

Cursor de lanzamiento
Abra la paleta de comandos (Cmd+P en macOS o Ctrl+P en Windows/Linux)
Busca "Keitaro" y selecciónalo.
Ahora puedes usar la API de Keitaro a través de Cursor

Herramientas disponibles

Campañas

list_campaigns - obtener una lista de campañas
get_campaign - obtener información sobre una campaña específica
create_campaign - crea una nueva campaña
update_campaign - actualizar una campaña existente
delete_campaign - eliminar una campaña

Flujos de tráfico

list_streams : obtiene una lista de flujos de tráfico para una campaña
get_stream - obtener información sobre una secuencia específica

Fuentes de tráfico

list_traffic_sources - obtener una lista de fuentes de tráfico
get_traffic_source : obtener información sobre una fuente de tráfico específica

Ofertas

list_offers - obtener una lista de ofertas
get_offer - obtener información sobre una oferta específica

Clics y conversiones

list_clicks - obtener una lista de clics
get_click - obtener información sobre un clic específico
list_conversions - obtener una lista de conversiones
get_conversion - obtener información sobre una conversión específica

Informes

get_report - genera un informe con parámetros específicos

Dominios

list_domains - obtener una lista de dominios
get_domain - obtener información sobre un dominio específico

Ejemplos de uso

Obtener una lista de campañas

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

Creando una nueva campaña

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

Obtener un informe

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

Desarrollo

Ejecutándose en modo de desarrollo

npm run dev

Probando el servidor MCP

npm run inspect

Keitaro TDS API MCP Plugin

Integrations