oxylabs/web-api-mcp

어떤 프로젝트인가요?

핵심 기능

• 01실시간 웹을 검색하고 제목, 설명, URL이 포함된 순위별 자연 검색 결과를 가져옵니다.
• 02페이지를 Markdown으로 스크래핑하거나 프롬프트 또는 schema를 통해 지정한 필드를 JSON으로 추출합니다.
• 03고유한 매개변수를 사용하는 전용 스크래퍼 엔드포인트를 호출합니다.
• 04호스팅된 원격 엔드포인트를 사용하거나 stdio 또는 HTTP로 자체 호스팅해 실행합니다.
• 05로컬 실행 시 지나치게 큰 페이지를 디스크에 저장하고 청크 단위로 읽습니다.
• 06API 지출 한도를 설정하는 서버별 요청 속도 제한 기능을 선택적으로 사용할 수 있습니다.

활용 사례

• 코딩 또는 리서치 에이전트에 실시간 웹 검색 및 페이지 읽기 기능을 제공합니다.
• 제품 또는 목록 페이지에서 구조화된 필드를 추출해 에이전트 워크플로에 활용합니다.
• 사내 네트워크에서 팀이 함께 사용하는 스크래핑 서비스를 운영합니다.
• API 키와 네트워크 접근을 자체 인프라 안에서 관리합니다.

빠른 시작

1. 1

   대시보드에서 Oxylabs Web API 키를 발급받으세요

2. 2

   API 키를 환경 변수로 설정하세요

   export OXYLABS_WEB_API_KEY="your_api_key_here"
3. 3

   Claude Code를 호스팅된 Remote MCP 서버에 연결하세요

   claude mcp add --transport http --scope user oxylabs-web-api https://mcp.oxylabs.io/web-api-mcp --header "Authorization: Bearer ${OXYLABS_WEB_API_KEY}"

사용 전 알아둘 점

• !Oxylabs Web API 키가 필요하며, AI 파서 사용 요금은 스크래핑 요금에 추가로 청구됩니다.
• !직접 호스팅하려면 Python 3.10 이상과 uv가 필요하며, 업데이트는 직접 관리해야 합니다.
• !HTTP 전송을 사용하려면 MCP_ALLOWED_HOSTS를 설정해야 합니다. 설정하지 않으면 요청이 거부됩니다.

포함된 컬렉션

토픽

자주 묻는 질문

web-api-mcp은(는) 무엇인가요?

Oxylabs Web API를 통해 AI 에이전트에 검색, 페이지 스크래핑, 전용 스크래퍼를 제공하는 자체 호스팅 가능한 MCP 서버입니다. Oxylabs Web API용 공식 Model Context Protocol 서버입니다. MCP를 지원하는 에이전트라면 MCP 연결 하나로 실시간 웹을 검색하고, 페이지를 Markdown이나 JSON으로 읽으며(JavaScript 비중이 높거나 봇 차단이 적용된 페이지 포함), 특정 사이트 전용 스크래퍼를 호출할 수 있습니다.

web-api-mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

web-api-mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

web-api-mcp은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. web-api-mcp의 마지막 커밋은 2026년 11월 6일입니다.

web-api-mcp은(는) 어디에 사용할 수 있나요?

코딩 또는 리서치 에이전트에 실시간 웹 검색 및 페이지 읽기 기능을 제공합니다. 제품 또는 목록 페이지에서 구조화된 필드를 추출해 에이전트 워크플로에 활용합니다. 사내 네트워크에서 팀이 함께 사용하는 스크래핑 서비스를 운영합니다. API 키와 네트워크 접근을 자체 인프라 안에서 관리합니다.

web-api-mcp는 어떻게 설치하나요?

대시보드에서 Oxylabs Web API 키를 발급받으세요 API 키를 환경 변수로 설정하세요: export OXYLABS_WEB_API_KEY="your_api_key_here" Claude Code를 호스팅된 Remote MCP 서버에 연결하세요: claude mcp add --transport http --scope user oxylabs-web-api https://mcp.oxylabs.io/web-api-mcp --header "Authorization: Bearer ${OXYLABS_WEB_API_KEY}"

web-api-mcp은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/oxylabs/web-api-mcp