@channel47/dataforseo-mcp-server 1.0.0

package/dist/api/types.d.ts

@@ -0,0 +1,89 @@
+export interface DataForSeoResponse<T> {
+    version: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+    cost: number;
+    tasks_count: number;
+    tasks_error: number;
+    tasks: T[];
+}
+export interface DataForSeoTask<T> {
+    id: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+    cost: number;
+    result_count: number;
+    path: string[];
+    data: any;
+    result: T[];
+}
+export interface DataForSeoErrorResponse {
+    version: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+}
+export interface TaskPostResponse<T = any> {
+    id: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+    cost: number;
+    result_count: number;
+    path: string[];
+    data: T;
+    result: null;
+}
+export interface TaskReadyResponse {
+    id: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+}
+export interface TaskGetResponse<T = any> {
+    id: string;
+    status_code: number;
+    status_message: string;
+    time: string;
+    cost: number;
+    result_count: number;
+    path: string[];
+    data: any;
+    result: T[];
+}
+export interface LocationParameters {
+    location_name?: string;
+    location_code?: number;
+    language_name?: string;
+    language_code?: string;
+}
+export interface PaginationParameters {
+    limit?: number;
+    offset?: number;
+}
+export interface DateRangeParameters {
+    date_from?: string;
+    date_to?: string;
+}
+export interface TaskParameters {
+    tag?: string;
+    priority?: number;
+    postback_url?: string;
+    postback_data?: string;
+}
+export declare enum StatusCode {
+    SUCCESS = 20000,
+    TASK_CREATED = 20100,
+    NO_RESULTS = 20011,
+    ERROR = 40000,
+    AUTH_ERROR = 40100,
+    INVALID_PARAMETERS = 40200
+}
+export declare enum ApiMethod {
+    TASK_POST = "task_post",
+    TASKS_READY = "tasks_ready",
+    TASK_GET = "task_get",
+    LIVE = "live"
+}

package/dist/api/types.js

@@ -0,0 +1,19 @@
+// Status codes and messages
+export var StatusCode;
+(function (StatusCode) {
+    StatusCode[StatusCode["SUCCESS"] = 20000] = "SUCCESS";
+    StatusCode[StatusCode["TASK_CREATED"] = 20100] = "TASK_CREATED";
+    StatusCode[StatusCode["NO_RESULTS"] = 20011] = "NO_RESULTS";
+    StatusCode[StatusCode["ERROR"] = 40000] = "ERROR";
+    StatusCode[StatusCode["AUTH_ERROR"] = 40100] = "AUTH_ERROR";
+    StatusCode[StatusCode["INVALID_PARAMETERS"] = 40200] = "INVALID_PARAMETERS";
+})(StatusCode || (StatusCode = {}));
+// API Methods
+export var ApiMethod;
+(function (ApiMethod) {
+    ApiMethod["TASK_POST"] = "task_post";
+    ApiMethod["TASKS_READY"] = "tasks_ready";
+    ApiMethod["TASK_GET"] = "task_get";
+    ApiMethod["LIVE"] = "live";
+})(ApiMethod || (ApiMethod = {}));
+//# sourceMappingURL=types.js.map

package/dist/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":"AAuFA,4BAA4B;AAC5B,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,qDAAe,CAAA;IACf,+DAAoB,CAAA;IACpB,2DAAkB,CAAA;IAClB,iDAAa,CAAA;IACb,2DAAkB,CAAA;IAClB,2EAA0B,CAAA;AAC5B,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAED,cAAc;AACd,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,oCAAuB,CAAA;IACvB,wCAA2B,CAAA;IAC3B,kCAAqB,CAAA;IACrB,0BAAa,CAAA;AACf,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { setupApiClient } from "./api/client.js";
+import { registerKeywordsTools } from "./api/keywords/index.js";
+async function main() {
+    // Get authentication credentials from environment variables
+    const dataForSeoLogin = process.env.DATAFORSEO_LOGIN;
+    const dataForSeoPassword = process.env.DATAFORSEO_PASSWORD;
+    if (!dataForSeoLogin || !dataForSeoPassword) {
+        console.error("Error: DataForSEO API credentials not provided");
+        console.error("Please set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD environment variables");
+        process.exit(1);
+    }
+    // Setup API client
+    const apiClient = setupApiClient(dataForSeoLogin, dataForSeoPassword);
+    // Create an MCP server
+    const server = new McpServer({
+        name: "DataForSEO Keywords MCP Server",
+        version: "1.0.0",
+    });
+    // Register keyword research tools (Google Ads, Bing Ads, Google Trends)
+    registerKeywordsTools(server, apiClient);
+    // Start receiving messages on stdin and sending messages on stdout
+    const transport = new StdioServerTransport();
+    console.error("DataForSEO Keywords MCP Server starting...");
+    await server.connect(transport);
+    console.error("DataForSEO Keywords MCP Server connected");
+}
+main().catch((error) => {
+    console.error("Error in DataForSEO Keywords MCP Server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,KAAK,UAAU,IAAI;IACjB,4DAA4D;IAC5D,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACrD,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAE3D,IAAI,CAAC,eAAe,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5C,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;QAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,MAAM,SAAS,GAAG,cAAc,CAAC,eAAe,EAAE,kBAAkB,CAAC,CAAC;IAEtE,uBAAuB;IACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,gCAAgC;QACtC,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,wEAAwE;IACxE,qBAAqB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAEzC,mEAAmE;IACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAE5D,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@channel47/dataforseo-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for keyword research via DataForSEO API - built for search and shopping media buyers",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "dataforseo-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "dataforseo",
+    "api",
+    "seo",
+    "keyword-research",
+    "google-ads",
+    "bing-ads"
+  ],
+  "author": "channel47",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/channel47/dataforseo-mcp-server.git"
+  },
+  "homepage": "https://github.com/channel47/dataforseo-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/channel47/dataforseo-mcp-server/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "axios": "^1.6.7",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.19",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  }
+}