olostep-mcp

by olostep
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

  • Provides structured data from Google search results through the google_search tool, including organic search results, knowledge graph data, and related questions

  • Supports waiting for JavaScript-heavy websites to render before scraping content, with configurable wait times

  • Retrieves webpage content in clean markdown format for easier consumption and formatting

올로스텝 MCP 서버

웹 스크래핑, 콘텐츠 추출 및 검색 기능을 위해 Olostep 과 통합되는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. Olostep MCP 서버를 설정하려면 API 키가 필요합니다. API 키는 Olostep 웹사이트 에 가입하여 받을 수 있습니다.

특징

  • 깔끔한 마크다운 포맷을 사용한 웹 페이지 콘텐츠 추출
  • 구조화된 데이터 추출을 통한 Google 검색 결과
  • 웹사이트 URL 검색 및 매핑
  • 지리적으로 타겟팅된 콘텐츠를 위한 국가별 요청 라우팅
  • JavaScript가 많은 웹사이트에 대한 구성 가능한 대기 시간
  • 포괄적인 오류 처리 및 보고
  • 간단한 API 키 구성

설치

npx로 실행

지엑스피1

수동 설치

npm install -g olostep-mcp

Claude Desktop에서 실행

claude_desktop_config.json 에 다음을 추가하세요:

{ "mcpServers": { "mcp-server-olostep": { "command": "npx", "args": ["-y", "olostep-mcp"], "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE" } } } }

또는 더 간단한 방법으로 장치 터미널에서 다음 코드를 실행하여 Smithery CLI를 통해 설치할 수 있습니다.

npx -y @smithery/cli install @olostep/olostep-mcp-server --client claude

윈드서프에서 달리기

./codeium/windsurf/model_config.json 에 다음을 추가하세요.

{ "mcpServers": { "mcp-server-olostep": { "command": "npx", "args": ["-y", "olostep-mcp"], "env": { "OLOSTEP_API_KEY": "YOUR_API_KEY_HERE" } } } }

커서에서 실행

Cursor에서 Olostep MCP를 구성하려면:

  1. 커서 설정 열기
  2. 기능 > MCP 서버로 이동하세요
  3. "+ 새 MCP 서버 추가"를 클릭하세요
  4. 다음을 입력하세요.
    • 이름: "olostep-mcp"(또는 원하는 이름)
    • 유형: "명령"
    • 명령어: env OLOSTEP_API_KEY=your-api-key npx -y olostep-mcp

your-api-key Olostep API 키로 바꾸세요.

구성

환경 변수

  • OLOSTEP_API_KEY : Olostep API 키(필수)

사용 가능한 도구

1. 웹페이지 콘텐츠 가져오기( get_webpage_content )

JavaScript 렌더링을 지원하여 깔끔한 마크다운 형식으로 웹페이지 콘텐츠를 검색합니다.

{ "name": "get_webpage_content", "arguments": { "url_to_scrape": "https://example.com", "wait_before_scraping": 1000, "country": "US" } }

매개변수:

  • url_to_scrape : 스크래핑할 웹페이지의 URL(필수)
  • wait_before_scraping : 스크래핑을 시작하기 전 대기 시간(밀리초)(기본값: 0)
  • country : 요청을 로드할 거주 국가(예: 미국, 캐나다, 영국)(선택 사항)

응답:

{ "content": [ { "type": "text", "text": "# Example Website\n\nThis is the markdown content of the webpage..." } ] }

2. 웹사이트 URL 가져오기( get_website_urls )

쿼리와의 관련성을 기준으로 정렬된 웹사이트에서 관련 URL을 검색하여 불러옵니다.

{ "name": "get_website_urls", "arguments": { "url": "https://example.com", "search_query": "your search term" } }

매개변수:

  • url : 매핑할 웹사이트의 URL (필수)
  • search_query : URL을 정렬할 검색 쿼리(필수)

응답:

{ "content": [ { "type": "text", "text": "Found 42 URLs matching your query:\n\nhttps://example.com/page1\nhttps://example.com/page2\n..." } ] }

Google 검색 결과에서 구조화된 데이터를 검색합니다.

{ "name": "google_search", "arguments": { "query": "your search query", "country": "US" } }

매개변수:

  • query : 수행할 검색 쿼리(필수)
  • country : 지역화된 결과에 대한 국가 코드(예: US, GB)(기본값: "US")

응답에는 다음이 포함됩니다.

  • 제목, 링크, 스니펫이 포함된 유기적 검색 결과
  • 사용 가능한 경우 지식 그래프 데이터
  • 관련 질문 (사람들이 묻는 질문)
  • 관련 검색
  • 리치 스니펫 및 기타 구조화된 데이터

오류 처리

서버는 강력한 오류 처리 기능을 제공합니다.

  • API 문제에 대한 자세한 오류 메시지
  • 네트워크 오류 보고
  • 인증 실패 처리
  • 요금 제한 정보

오류 응답 예:

{ "isError": true, "content": [ { "type": "text", "text": "Olostep API Error: 401 Unauthorized. Details: {\"error\":\"Invalid API key\"}" } ] }

특허

ISC 라이센스

ID: ur5ulf3b8e