MMCPMarkets
SS

scrapegraphai/scrapegraph-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

119 stars 41 forks Качество 80 Тренд 19MIT
Repository Install

scrapegraphai/scrapegraph-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/scrapegraphai/scrapegraph-mcp.

Обзор

scrapegraphai/scrapegraph-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/scrapegraphai/scrapegraph-mcp.

Обзор (машинный перевод)

Готовый к производству сервер Model Context Protocol (MCP), обеспечивающий бесшовную интеграцию с AI API ScrapeGraph. Этот сервер позволяет языковым моделям использовать передовые возможности веб-скрейпинга на базе ИИ с корпоративной надёжностью.

Содержание

  • Ключевые особенности
  • Быстрый старт
  • Доступные инструменты
  • Инструкции по установке
  • Использование удалённого сервера
  • Локальное использование
  • Интеграция с Google ADK
  • Примеры использования
  • Обработка ошибок
  • Распространённые проблемы
  • Разработка
  • Вклад
  • Документация
  • Стек технологий
  • Лицензия

API v2

Этот MCP-сервер нацелен на ScrapeGraph API v2 (https://v2-api.scrapegraphai.com/api), выровненный 1:1 с scrapegraph-py PR #84. Авторизация использует SGAI-APIKEY заголовка. Переменные окружения отражают Python SDK:

  • SGAI_API_URL — переопределить базовый URL (по умолчанию [https://v2-api.scrapegraphai.com/api)
  • SGAI_TIMEOUT — тайм-аут запроса за секунды (по умолчанию [120)
  • SGAI_API_KEY — ключ API (также может передаваться через заголовок MCP scrapegraphApiKey или X-API-Key)

Псевдонимы Legacy (до сих пор почитаются): SCRAPEGRAPH_API_BASE_URL для SGAI_API_URL, SGAI_TIMEOUT_S для SGAI_TIMEOUT.

Ключевые особенности

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

ScrapeGraph MCP Server

A production-ready Model Context Protocol (MCP) server that provides seamless integration with the ScrapeGraph AI API. This server enables language models to leverage advanced AI-powered web scraping capabilities with enterprise-grade reliability.

Table of Contents

API v2

This MCP server targets ScrapeGraph API v2 (https://v2-api.scrapegraphai.com/api), aligned 1:1 with scrapegraph-py PR #84. Auth uses the SGAI-APIKEY header. Environment variables mirror the Python SDK:

  • SGAI_API_URL — override the base URL (default https://v2-api.scrapegraphai.com/api)
  • SGAI_TIMEOUT — request timeout in seconds (default 120)
  • SGAI_API_KEY — API key (can also be passed via MCP scrapegraphApiKey or X-API-Key header)

Legacy aliases (still honored): SCRAPEGRAPH_API_BASE_URL for SGAI_API_URL, SGAI_TIMEOUT_S for SGAI_TIMEOUT.

Key Features

  • Scrape & extract: scrape (POST /scrape, multi-format), extract (POST /extract, URL + prompt)
  • Search: search (POST /search; num_results clamped 3–20)
  • Crawl: Async multi-page crawl with crawl_start / crawl_get_status / crawl_stop / crawl_resume
  • Schema: schema (POST /schema) — generate or augment a JSON Schema from a prompt
  • Monitors: Scheduled jobs via monitor_create, monitor_list, monitor_get, pause/resume/delete, monitor_activity (paginated tick history)
  • Account: credits, history
  • Easy integration: Claude Desktop, Cursor, Smithery, HTTP transport
  • Developer docs: .agent/ folder

Migration: v2 → v3

v3 renames every MCP tool that diverged from the v2 API docs. Hard rename, no aliases.

v2 (old) v3 (new)
smartscraper extract
searchscraper search
smartcrawler_initiate crawl_start
Открыть полный README на GitHub

Установка

npx -y @smithery/cli@latest run @ScrapeGraphAI/scrapegraph-mcp --config \"{\\\"scrapegraphApiKey\\\":\\\"YOUR-SGAI-API-KEY\\\"}\
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "@ScrapeGraphAI-scrapegraph-mcp": { "command": "npx", "args": [ "-y", "@smithery/cli@latest", "run", "@ScrapeGraphAI/scrapegraph-mcp", "--config", "\"{\\\"scrapegraphApiKey\\\":\\\"YOUR-SGAI-API-KEY\\\"}\"" ] } } }