DataForSEO MCP 서버
DataForSEO를 위한 MCP(Model Context Protocol) 서버 구현으로, Claude가 선택된 DataForSEO API와 상호 작용하고 표준화된 인터페이스를 통해 SEO 데이터를 얻을 수 있습니다.
특징
- SERP API: Google, Bing, Yahoo의 실시간 검색 엔진 결과 페이지(SERP) 데이터
- KEYWORDS_DATA API: 검색 볼륨, 클릭당 비용 및 기타 지표를 포함한 키워드 조사 및 클릭스트림 데이터
- ONPAGE API: 사용자 정의 가능한 매개변수에 따라 웹사이트와 웹페이지를 크롤링하여 온페이지 SEO 성과 지표를 얻을 수 있습니다.
- DATAFORSEO_LABS API: DataForSEO의 사내 데이터베이스와 독점 알고리즘을 기반으로 한 키워드, SERP, 도메인에 대한 데이터입니다.
필수 조건
- Node.js(v14 이상)
- DataForSEO API 자격 증명(API 로그인 및 비밀번호)
설치
- 저장소를 복제합니다.
지엑스피1
- 종속성 설치:
- 환경 변수 설정:
# Required
export DATAFORSEO_USERNAME=your_username
export DATAFORSEO_PASSWORD=your_password
# Optional: specify which modules to enable (comma-separated)
# If not set, all modules will be enabled
export ENABLED_MODULES="SERP,KEYWORDS_DATA,ONPAGE,DATAFORSEO_LABS,BACKLINKS,BUSINESS_DATA,DOMAIN_ANALYTICS"
# Optional: enable full API responses
# If not set or set to false, the server will filter and transform API responses to a more concise format
# If set to true, the server will return the full, unmodified API responses
export DATAFORSEO_FULL_RESPONSE="false"
NPM 패키지로 설치
패키지를 글로벌하게 설치할 수 있습니다:
npm install -g dataforseo-mcp-server
또는 설치하지 않고 바로 실행하세요.
npx dataforseo-mcp-server
명령을 실행하기 전에 환경 변수를 설정하는 것을 잊지 마세요.
# Required environment variables
export DATAFORSEO_USERNAME=your_username
export DATAFORSEO_PASSWORD=your_password
# Run with npx
npx dataforseo-mcp-server
건물과 운영
프로젝트를 빌드하세요:
서버를 실행합니다:
사용 가능한 모듈
다음 모듈을 활성화/비활성화할 수 있습니다.
SERP : Google, Bing, Yahoo의 실시간 SERP 데이터KEYWORDS_DATA : 키워드 조사 및 클릭스트림 데이터ONPAGE : 웹사이트와 웹페이지를 크롤링하여 온페이지 SEO 성과 지표를 얻습니다.DATAFORSEO_LABS : DataForSEO의 데이터베이스와 알고리즘을 기반으로 한 키워드, SERP, 도메인에 대한 데이터BACKLINKS : 모든 도메인, 하위 도메인 또는 웹페이지에 대한 인바운드 링크, 참조 도메인 및 참조 페이지에 대한 데이터입니다.BUSINESS_DATA : 다음 플랫폼에 공개적으로 공유된 비즈니스 리뷰 및 비즈니스 정보를 기반으로 함: Google, Trustpilot, Tripadvisor;DOMAIN_ANALYTICS : 웹사이트 구축에 사용되는 모든 기술을 식별하고 Whois 데이터를 제공합니다.
새로운 도구/모듈 추가
모듈 구조
각 모듈은 특정 DataForSEO API에 해당합니다.
구현 옵션
다음 중 하나를 선택할 수 있습니다.
- 기존 모듈에 새 도구 추가
- 완전히 새로운 모듈을 만듭니다
새 도구 추가
새 모듈이나 기존 모듈에 새 도구를 추가하는 방법은 다음과 같습니다.
// src/modules/your-module/tools/your-tool.tool.ts
import { BaseTool } from '../../base.tool';
import { DataForSEOClient } from '../../../client/dataforseo.client';
import { z } from 'zod';
export class YourTool extends BaseTool {
constructor(private client: DataForSEOClient) {
super(client);
// DataForSEO API returns extensive data with many fields, which can be overwhelming
// for AI agents to process. We select only the most relevant fields to ensure
// efficient and focused responses.
this.fields = [
'title', // Example: Include the title field
'description', // Example: Include the description field
'url', // Example: Include the URL field
// Add more fields as needed
];
}
getName() {
return 'your-tool-name';
}
getDescription() {
return 'Description of what your tool does';
}
getParams(): z.ZodRawShape {
return {
// Required parameters
keyword: z.string().describe('The keyword to search for'),
location: z.string().describe('Location in format "City,Region,Country" or just "Country"'),
// Optional parameters
fields: z.array(z.string()).optional().describe('Specific fields to return in the response. If not specified, all fields will be returned'),
language: z.string().optional().describe('Language code (e.g., "en")'),
};
}
async handle(params: any) {
try {
// Make the API call
const response = await this.client.makeRequest({
endpoint: '/v3/dataforseo_endpoint_path',
method: 'POST',
body: [{
// Your request parameters
keyword: params.keyword,
location: params.location,
language: params.language,
}],
});
// Validate the response for errors
this.validateResponse(response);
//if the main data array is specified in tasks[0].result[:] field
const result = this.handleDirectResult(response);
//if main data array specified in tasks[0].result[0].items field
const result = this.handleItemsResult(response);
// Format and return the response
return this.formatResponse(result);
} catch (error) {
// Handle and format any errors
return this.formatErrorResponse(error);
}
}
}
새 모듈 만들기
src/modules/ 아래에 모듈용 새 디렉토리를 만듭니다.
mkdir -p src/modules/your-module-name
- 모듈 파일을 만듭니다.
// src/modules/your-module-name/your-module-name.module.ts
import { BaseModule } from '../base.module';
import { DataForSEOClient } from '../../client/dataforseo.client';
import { YourTool } from './tools/your-tool.tool';
export class YourModuleNameModule extends BaseModule {
constructor(private client: DataForSEOClient) {
super();
}
getTools() {
return {
'your-tool-name': new YourTool(this.client),
};
}
}
src/config/modules.config.ts 에 모듈을 등록하세요:
export const AVAILABLE_MODULES = [
'SERP',
'KEYWORDS_DATA',
'ONPAGE',
'DATAFORSEO_LABS',
'YOUR_MODULE_NAME' // Add your module name here
] as const;
src/index.ts 에서 모듈을 초기화합니다.
if (isModuleEnabled('YOUR_MODULE_NAME', enabledModules)) {
modules.push(new YourModuleNameModule(dataForSEOClient));
}
다음으로 어떤 엔드포인트/API를 지원하길 원하시나요?
저희는 이 MCP 서버의 기능 확장을 위해 끊임없이 노력하고 있습니다. 지원되기를 원하는 특정 DataForSEO 엔드포인트나 API가 있으시면 다음을 확인해 주세요.
- DataForSEO API 설명서를 확인하여 사용 가능한 기능을 확인하세요.
- 다음을 사용하여 GitHub 저장소에 이슈를 열어보세요.
- 지원하려는 API/엔드포인트
- 사용 사례에 대한 간략한 설명
- 구체적으로 구현하고 싶은 기능이 있는지 설명해 주세요.
귀하의 피드백은 다음에 지원할 API의 우선순위를 정하는 데 도움이 됩니다!
자원