SS

scrapegraphai/scrapegraph-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

120 stars 41 forks 品質 80 トレンド 20MIT

scrapegraphai/scrapegraph-mcpは、https://github.com/scrapegraphai/scrapegraph-mcp.からインポートされたMCPサーバー候補です。

概要

scrapegraphai/scrapegraph-mcpは、https://github.com/scrapegraphai/scrapegraph-mcp.からインポートされたMCPサーバー候補です。

概要(AI 翻訳)

ScrapeGraph AI APIとのシームレスな統合を提供する本番対応のモデルコンテキストプロトコル(MCP)サーバーです。このサーバーは言語モデルが高度なAI搭載ウェブスクレイピング機能をエンタープライズレベルの信頼性で活用できるようにします。

目次

  • 主な特徴
  • クイックスタート
  • 利用可能なツール
  • セットアップ手順
  • リモートサーバー利用
  • ローカルな使用状況
  • 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ヘッダー経由でも渡す)

レガシーの別名(現在も使用中):SCRAPEGRAPH_API_BASE_URLはSGAI_API_URL、SGAI_TIMEOUT_SはSGAI_TIMEOUT。

主な特徴

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

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
GitHub で README 全文を見る

インストール

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\\\"}\"" ] } } }