Geekflare

@geekflare/mcp

Geekflare の公式 MCP（Model Context Protocol）サーバーです。Geekflare のウェブインテリジェンスツールを Claude、Cursor、Windsurf などの AI アシスタントに直接接続できます。

セットアップ

API キーを取得する

geekflare.com/api でサインアップし、ダッシュボードから API キーをコピーします。

Claude Desktop

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor / Windsurf

MCP の設定に以下を追加します：

{
  "mcpServers": {
    "geekflare": {
      "command": "npx",
      "args": ["-y", "@geekflare/mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "geekflare": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "API_KEY=your-api-key-here", "geekflare/mcp"]
    }
  }
}

---

利用可能なツール

webScrape

任意の URL からページ全体のコンテンツをスクレイピングします。HTML、Markdown、JSON、または LLM 向けに最適化されたテキストを返します。すぐに使える抽出テンプレート、カスタム CSS/XPath スキーマ、AI を活用した抽出による構造化データも取得できます。 | パラメーター | 型 | デフォルト | 説明 | | ------------------ | --------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- | --------- | --------------------------------------- | | url * | string | — | 対象 URL | | device | desktop | mobile | desktop | エミュレートするデバイス | | format | array | ["markdown"] | 出力形式（最大 3 種類）：html、markdown、json、markdown-llm、html-llm、text、text-llm | | proxyMode | boolean | "auto" | false | false はプロキシを使用せず、auto はサイトがリクエストをブロックした場合にプロキシ経由で再試行し、true は常にプロキシを使用します | | proxyCountry | string | — | 国の ISO コード（例："us"）を指定して経由先を設定します。プロキシが有効な場合に使用されます | | renderJS | boolean | auto | 抽出前に JavaScript を実行します。省略した場合、ページで必要かどうかに基づいて自動的に設定されます | | fileOutput | boolean | false | インラインコンテンツの代わりにダウンロード URL を返します | | blockAds | boolean | true | スクレイピング中に広告をブロックします | | stealth | boolean | false | CAPTCHA を回避します（処理が遅くなります） | | waitTime | number | 0 | コンテンツを取得する前に、ページの読み込み後に待機する秒数 | | extractionMode | default | cssSchema | xpathSchema | template | default | format に json が含まれる場合にのみ使用されます | | template | product | contact | — | extractionMode が template の場合に使用する、すぐに使える抽出テンプレート | | extractionSchema | object | — | cssSchema／xpathSchema モード用のカスタムフィールド抽出スキーマ | | aiPrompt | object | — | スクレイピングしたページの AI による抽出／分析に使用します。プロンプト、スキーマ、リスト、要約、感情分析、キーワードの各モードに対応しています。クレジットを 6 消費します |

---

metaScrape

メタタグ（タイトル、説明、Open Graph、Twitterカードなど）をスクレイピングします。

| パラメーター | 型 | デフォルト | 説明 | | -------------- | --------- | ---------- | ----------------------------------------------- | ----------------- | | url * | string | — | 対象 URL | | device | desktop | mobile | desktop | エミュレートするデバイス | | format | json | markdown | json | レスポンス形式 | | proxyCountry | string | — | 国の ISO コード | | renderJS | boolean | true | JavaScript を実行するかどうか | | fileOutput | boolean | false | インラインコンテンツの代わりにダウンロード URL を返す | | blockAds | boolean | true | スクレイピング中に広告をブロックする |

---

brand

ウェブサイトのドメインに関する構造化されたブランド情報（ブランドアイデンティティ、ロゴ、色、タイポグラフィ、ソーシャルプロフィール、リンク、ページメタデータ、企業情報など）を取得します。

brand ツールは、2 段階のブランド情報を提供します。

• standard — ウェブサイトから取得できる構造化されたブランド情報を返します。
• enriched — 利用可能な場合、LLM が合成した追加の企業情報を含みます。

| パラメーター | 型 | デフォルト | 説明 | | --------- | ---------- | ---------- | ---------------------------------------------------------- | --------------------------------------------------------------------------------------- | | url * | string | — | 対象 URL | | refresh | boolean | false | オンデマンドで取得して、キャッシュされたブランドデータを更新します | | mode | standard | enriched | standard | 返すブランドデータの詳細度です。enriched には、LLM が合成した企業情報が含まれます |

例

{
  "url": "https://example.com",
  "mode": "enriched"
}

キャッシュされたデータを使用せず、新しい情報を取得するには：

{
  "url": "https://example.com",
  "refresh": true,
  "mode": "enriched"
}

レスポンスには、以下が含まれる場合があります。

• ブランド名、タグライン、説明、スローガン
• ロゴとファビコン
• ブランドカラーとパレット
• フォントとタイポグラフィ
• UI コンポーネントのスタイルと余白
• ソーシャルプロフィール
• ウェブサイトの重要なリンク
• ページメタデータと Open Graph 情報
• 業界、創業年、従業員数の範囲、収益の範囲、企業タイプ、ターゲット層など、入手可能な場合の企業情報

企業情報の充実度は、そのドメインで公開されている情報に左右されるため、個々の項目が省略される場合があります。

---

screenshot

Web サイトのスクリーンショットを撮影します。ページ全体、要素のみ、Retina、ダークモード、背景の透過、AI に適したリンクの強調表示に対応しています。

| パラメーター | 型 | デフォルト | 説明 | | ----------------------- | --------- | -------- | --------------------------------------------------------------- | ----------------- | ------------ | | url * | string | — | 対象 URL | | device | desktop | mobile | desktop | エミュレートするデバイス | | type | png | jpeg | webp | png | 画像形式 | | proxyCountry | string | — | 国の ISO コード | | fullPage | boolean | false | ページ全体を撮影 | | selector | string | — | 撮影する要素の CSS セレクター | | fallbackToFullPage | boolean | false | selector が見つからない場合、ページ全体の撮影に切り替えます | | blockAds | boolean | true | 広告をブロック | | hideCookie | boolean | true | Cookie バナーを削除 | | skipCaptcha | boolean | true | ボット対策チャレンジを回避 | | addTimestamp | boolean | false | タイムスタンプを追加 | | highlightLinks | boolean | false | リンク／ボタンの周囲に枠線を描画 — AI ビジョンモデルに便利 | | pageHeight | number | — | カスタムページの高さ（ピクセル単位） | | viewportWidth | number | — | ビューポートの幅 | | viewportHeight | number | — | ビューポートの高さ | | captureBeyondViewport | boolean | — | 設定したビューポートの範囲外のコンテンツも撮影 | | delay | number | — | ページの読み込み後に待機する秒数 | | quality | number | 90 | JPEG／WEBP の画像品質 | | scaleFactor | number | — | デバイスのピクセル比 | | theme | light | dark | auto | auto | 配色 | | removeBackground | boolean | false | ページの背景を削除（PNG のみ） | | disableAnimations | boolean | false | 撮影前に CSS アニメーションを停止 | | inline | boolean | false | CDN URL ではなく画像データをインラインで返す |

---

search

ウェブを検索し、整理された結果を返します。ウェブ、ニュース、画像検索に対応しており、オプションで AI による根拠付き回答も利用できます。

| パラメーター | 型 | デフォルト | 説明 | | ---------------- | --------- | ---------- | -------------------------------------------------- | ---------- | --------------- | ------ | --- | --------------- | | query * | string | — | 検索クエリ | | limit | number | 10 | 結果の件数 | | time | string | — | 期間フィルター：any、d、w、m、y、d7、h6 | | location | string | — | 結果をローカライズする国の ISO コード | | source | web | news | images | web | 検索ソース | | category | general | code | pdf | research | linkedin | wiki | — | 検索カテゴリ | | format | json | markdown | html | json | レスポンス形式 | | includeDomains | array | — | これらのドメインのみを含めます | | excludeDomains | array | — | これらのドメインを除外します | | groundedAnswer | boolean | false | 検索結果を統合した AI の回答を生成します | | scrape | boolean | false | 上位の検索結果ページもスクレイピングします | | scrapeLimit | number | 3 | scrape が有効な場合にスクレイピングするページ数 |

---

dnsRecord

ドメインの DNS レコードを検索します。

パラメーター	型	デフォルト
url *	string	—
types	array	サポートされているすべてのタイプ

サポートされている DNS レコードのタイプ：

A、AAAA、CNAME、MX、NS、SOA、TXT、CAA、SRV

---

siteStatus

サイトが稼働中か停止中かを確認します。

パラメーター	型	デフォルト
url *	string	—
proxyCountry	string	—
followRedirect	boolean	false

---

redirectCheck

URL のリダイレクトチェーン全体を追跡します。

パラメーター	型
url *	string
proxyCountry	string

---

brokenLink

ウェブページ上のすべてのリンク切れを検出します。

パラメーター	型	デフォルト
url *	string	—
proxyCountry	string	—
followRedirect	boolean	false

---

url2Pdf

任意のURLをダウンロード可能なPDFに変換します。

| パラメーター | 型 | デフォルト | 説明 | | --------------- | ---------- | ----------- | -------------------------- | ----------------- | -------- | ------- | --------- | ---- | ---------- | | url * | string | — | 対象URL | | device | desktop | mobile | desktop | エミュレートするデバイス | | format | a4 | a3 | a5 | a6 | letter | legal | a0–a2 | a4 | 用紙サイズ | | orientation | portrait | landscape | portrait | ページの向き | | proxyCountry | string | — | 国のISOコード | | scale | number | — | ズームレベル | | margin.top | number | 25 | 上余白（mm） | | margin.bottom | number | 25 | 下余白（mm） | | margin.left | number | 25 | 左余白（mm） | | margin.right | number | 25 | 右余白（mm） | | hideCookie | boolean | true | Cookieバナーを削除します | | skipCaptcha | boolean | true | ボット対策チャレンジを回避します | | addTimestamp | boolean | false | タイムスタンプを追加します |

---

openPorts

ホストの開放ポートをスキャンします。任意で、開放が見つかったポートのサービスとバージョンを検出できます。

パラメーター	型	説明	-----	------	------	-----------------------
url *	string	対象URLまたはホスト名
topPorts	50	100	500	1000	5000	よく使われる上位N個のポートをスキャンします
portRanges	string	カスタム範囲。例："80,443,1000-1010"
detectServices	boolean	trueの場合、開放ポートのサービス／バージョン検出も実行します

サービス検出

detectServices: trueを設定すると、開放が見つかったポートに対してNmapのサービス／バージョン検出を実行します。

{
  "url": "example.com",
  "topPorts": 100,
  "detectServices": true
}

成功すると、レスポンスには次のような情報を含むservices配列が含まれます。

• ポート番号
• ポートの状態
• 検出されたサービス名
• 製品名
• 製品バージョン
• 追加のサービス情報
• 利用可能な場合、推定されたOSの種類

レスポンス構造の例：

{
  "data": [22, 80, 443],
  "services": [
    {
      "port": 22,
      "state": "open",
      "service": {
        "name": "ssh",
        "product": "OpenSSH",
        "version": "9.6"
      }
    },
    {
      "port": 443,
      "state": "open",
      "service": {
        "name": "https"
      }
    }
  ]
}

サービス検出はベストエフォートであり、通常のポートスキャンより時間がかかる場合があります。

サービス検出が要求されたものの完了できない場合、APIはservicesErrorフィールドを返すことがあります。検出された開放ポートを含むdataフィールドは引き続き利用できます。

---

tlsScan

TLS/SSL設定（プロトコル、暗号スイート、証明書の詳細）を調査します。

パラメーター	型
url *	string

---

loadTime

任意の場所からページ全体の読み込み時間を測定します。オプションで、複数の場所から同時に到達可能性をテストできます。

Parameter	Type	Default	Description
url *	string	—	対象 URL
proxyCountry	string	—	国の ISO コード
followRedirect	boolean	false	リダイレクトを追跡します
targetCountries	array of string	—	デフォルトの米国でのテストに加えて、プロキシ経由でテストする最大 3 つの ISO 国コードです。設定すると、場所ごとの内訳を返します

---

mixedContent

混在コンテンツの問題（HTTPS ページ上の HTTP リソース）を検出します。

Parameter	Type	Default
url *	string	—
proxyCountry	string	—
followRedirect	boolean	false

---

dnsSec

ドメインで DNSSEC が有効になっており、正しく設定されているかを確認します。

Parameter	Type
url *	string

---

mtr

MTR（My Traceroute）ネットワーク診断テストを実行します。

Parameter	Type	Default
url *	string	—
proxyCountry	string	—
followRedirect	boolean	false

---

ping

ホストに ping を実行し、レイテンシを返します。

Parameter	Type
url *	string

---

lighthouse

パフォーマンス、SEO、アクセシビリティ、ベストプラクティスを対象に、Lighthouse の完全な監査を実行します。

| Parameter | Type | Default | Description | | ---------------- | --------------- | -------- | -------------------------- | ----------------- | | url * | string | — | 対象 URL | | device | desktop | mobile | desktop | エミュレートするデバイス | | proxyCountry | string | — | 国の ISO コード | | followRedirect | boolean | false | リダイレクトを追跡します | | parameters | array of string | — | 追加の Lighthouse CLI フラグ |

---

環境変数

Variable	Required	Description
API_KEY	✅	Geekflare API キー
API_BASE_URL	—	API ベース URL を上書きします（デフォルト：https://api.geekflare.com）

リンク

• API ドキュメント
• Geekflare API
• 問題を報告

ライセンス

MIT