Apifreaks Mcp Server

@apifreaks/mcp

APIFreaks の公式 Model Context Protocol（MCP） サーバーです。Claude、Cursor、Windsurf、または MCP 対応クライアントに追加すると、AI からリアルタイムの天気、WHOIS、DNS、SSL、ドメインの登録可否・評判・タイポスクワッティング、IP ジオロケーションと脅威インテリジェンス、通貨、コモディティ、スクリーンショット、PDF、VAT／IBAN／SWIFT、メールアドレスの検証、使い捨てメールアドレスのチェック、電話番号の検証、ジオコーディングなどを照会できます。

接続すると、どんなことを質問できますか？

🌦	「東京の7日間の天気予報を教えて。傘を持っていくべき？」
🔒	「stripe.com の SSL 証明書を確認して。有効ですか？有効期限はいつですか？」
🌍	「openai.com の登録者と登録時期を教えて。WHOIS レコードは最近変更されましたか？」
💱	「今日のリアルタイムレートで2500 USDをEUR、GBP、JPYに換算して。」
🔍	「この20個のドメイン名が登録可能か確認して。」
🛡	「paypal-login.xyz は危険ですか？ドメインの評判と信頼スコアを教えて。」
🕵	「paypal ブランドのタイポスクワッティングドメインを見つけて。」
📡	「github.com の DNS レコードを教えて。MX レコードと TXT レコードをすべて表示して。」

---

目次

• 要件
• 環境変数
• モジュール
• API キーの取得
• クイックスタート
• インテグレーションガイド
  • Claude Code
  • Codex CLI
  • Claude Desktop
  • Cursor
  • Windsurf
  • Cline
  • OpenCode
  • Gemini CLI
  • VS Code
  • Glama
• 利用可能なツール
• サポート
• ライセンス
• プライバシーポリシー

---

要件

• Node.js v20 以上
• APIFreaks API キー — 無料で登録

---

環境変数

変数	必須	説明
APIFREAKS_API_KEY	はい	APIFreaks API キー。apifreaks.com で取得できます
ENABLE_MODULES	はい	公開するモジュールをカンマ区切りで指定します。設定しない場合は list_modules のみ利用できます。これを呼び出すと、モジュール／ツールと追加の有効化方法を確認できます。モジュールを参照してください。

---

モジュール

このサーバーは多くの API に対応しています。すべてを tools/list で公開するとクライアントのコンテキストウィンドウを圧迫するため、必要なモジュールを選択して有効にします。

MCP クライアントの設定で ENABLE_MODULES を設定します。登録されるのは指定したモジュールだけです。設定がないか空の場合、利用できるのは list_modules のみです。これを呼び出すと、すべてのモジュールと、そのまま貼り付けられる ENABLE_MODULES=... の行が表示されます（既存のモジュールは残し、新しいモジュールを追加してください）。その後、再起動します。

ENABLE_MODULES=ip-intelligence,whois,dns,domain,weather

ハイフンとアンダースコアは相互に置き換え可能です（user-agent と user_agent のどちらも使えます）。不明な名前は無視され、標準エラーに記録されます。

モジュール	ツール
ip-intelligence	IP の位置情報と脅威インテリジェンス（単件＋一括）
geocoding	前方ジオコーディングと逆ジオコーディング
whois	ドメイン、IP、ASN、履歴、逆引き、一括
dns	ライブ検索、履歴、逆引き、一括
scraper	静的 HTML のスクレイピングと JS レンダリングによるスクレイピング
email-validation	検証と使い捨てアドレスのチェック（単件＋一括）
phone-validation	電話番号の単件および一括検証
ssl	ライブ証明書と完全な証明書チェーン
domain	利用可否、候補、一括、サブドメイン、レピュテーション、タイポスクワッティング
screenshot	キャプチャ、スクロールキャプチャ、一括
pdf	結合、分割、圧縮、保護、生成、変換
currency	ライブ／過去のレート、コンバーター、時系列、通貨記号、制限
commodity	ライブ／過去の価格（245 種以上）、変動、時系列、通貨記号
financial	VAT 税率、VAT 番号、IBAN、SWIFT/BIC
zipcode	検索、半径、距離、市区町村／地域
weather	現在の天気、予報、過去の天気、大気質、海洋、洪水、天文
geography	行政単位、国、都市、地域、国旗
timezone	検索と変換
user-agent	単件または一括のユーザーエージェント文字列の解析

---

API キーの取得

apifreaks.com にサインインするか、無料アカウントを作成してください。API キーはダッシュボードの API Keys にあります。

API ドキュメント全体：apifreaks.com/docs

---

クイックスタート

最も手早く接続する方法は、Claude Code CLI を使うことです。

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

ip-intelligence,currency,whois,dns,weather を、必要なモジュールに置き換えてください。Cursor、Windsurf、Cline などについては、以下の連携ガイドを参照してください。

---

連携ガイド

Claude Code

ターミナル経由（推奨）：

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

設定ファイル経由（~/.claude/settings.json）：

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

サーバーを追加した後、新しい Codex セッションを開始してください。

---

Claude Desktop

claude_desktop_config.json を編集します。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

保存後、Claude Desktop を再起動してください。

---

Cursor

プロジェクトのルートに .cursor/mcp.json を作成または編集します（全体設定の場合は ~/.cursor/mcp.json）。

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

または、Cursor Settings → MCP に移動し、UI からサーバーを追加してください。

---

Windsurf

~/.codeium/windsurf/mcp_config.json を編集します。

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Cline

Cline の MCP Servers パネルを開き、Configure、次に Advanced MCP Settings をクリックして cline_mcp_settings.json を開きます。または、直接編集します。

• macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows： %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

保存後、Cline を再起動してください。

---

OpenCode

~/.config/opencode/config.json を編集します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "apifreaks": {
      "type": "local",
      "command": ["npx", "-y", "@apifreaks/mcp"],
      "environment": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Gemini CLI

~/.gemini/settings.json を編集します（プロジェクト単位の設定の場合は、プロジェクトのルートにある .gemini/settings.json を編集します）。

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

VS Code（GitHub Copilot / Continue）

ワークスペースに .vscode/mcp.json を作成します。

{
  "servers": {
    "apifreaks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Glama

APIFreaks MCP サーバーはGlamaに掲載されています。Glama では、Claude Desktop やその他の MCP クライアントにワンクリックで接続し、自動設定できます。また、定期的なセキュリティスキャンとツールの品質スコアリングも提供しています。

Glama の掲載ページで Connect をクリックして、画面の指示に従ってください。クライアントに適した設定が自動で生成されます。

---

利用可能なツール

list_modules（常に利用可能）

オプトイン方式の ENABLE_MODULES 用モジュールカタログです。ツールリストに必要な機能がない場合や、対応範囲を確認する場合に呼び出してください。実行中のツールはすでに tools/list に表示されます。貼り付けてすぐに使える設定行には needs_enable[].enable_line を使用し、その後再起動してください。

---

IP インテリジェンス（ip-intelligence）— 4 個のツール

あらゆる IP アドレスの位置情報、ISP、ネットワーク、脅威データを取得します。

ツール	説明
ipgeolocation_lookup	IP またはホスト名の位置情報、ASN、企業、通貨、タイムゾーン
ipgeolocation_bulk_lookup	1 回のリクエストで最大 50,000 件の IP の同じ位置情報を取得
ip_security_lookup	1 件の IP の脅威スコアと VPN／プロキシ／Tor／ボット／スパム／クラウド／ゲートウェイの各シグナル
ip_security_bulk_lookup	1 回のリクエストで最大 50,000 件の IP の同じ脅威インテリジェンスを取得

---

ジオコーディング（geocoding）— 2 個のツール

住所と座標を相互に変換します。

ツール	説明
geocode_forward	住所または地名を座標に変換
geocode_reverse	座標を住所に変換

---

WHOIS（whois）— 6 個のツール

過去の記録を含む、ドメインと IP の所有者データを取得します。

ツール	説明
whois_domain_lookup	ドメイン名の最新 WHOIS レコード
whois_ip_lookup	IPv4 または IPv6 アドレスの WHOIS 所有者情報とネットワークデータ
whois_asn_lookup	自律システム番号（ASN）の WHOIS データ
whois_domain_history	ドメインの過去の WHOIS スナップショット（1986 年まで遡るデータ）
whois_reverse_lookup	所有者名、メールアドレス、企業名、キーワードで WHOIS レコードを検索
whois_bulk_domain_lookup	1 回で最大 100 件のドメインの最新 WHOIS データを取得

---

DNS（dns）— 4 個のツール

最新の DNS レコード、履歴、逆引きを取得します。

ツール	説明
dns_lookup	ホスト名のリアルタイム DNS レコード（A、AAAA、MX、NS、TXT、CNAME、SOA、SPF）
dns_history	ホスト名の過去の DNS レコードのスナップショット
dns_reverse	特定の DNS レコード値を指すすべてのホスト名を検索
dns_bulk_lookup	1 回で最大 100 件のホスト名のリアルタイム DNS レコードを取得

---

スクレイパー（scraper）— 2 個のツール

URL から HTML または構造化フィールドを抽出します。まず静的モードを使用し、ページでブラウザーが必要な場合に限り JavaScript をレンダリングします。

ツール	説明
scraper_scrape	静的 HTML をスクレイピング（抽出／フォーム送信は任意）。指示を空にするとページ全体を返します
scraper_scrape_js	JavaScript のレンダリング、ブラウザー操作、プロキシ、任意の CAPTCHA 解決を使用してスクレイピング

---

メールアドレス検証（email-validation）— 4 個のツール

メールの到達性、構文、ドメイン、任意の IP エンリッチメント、および使い捨てメールプロバイダーを確認します。

ツール	説明
email_validate	1 件のメールアドレスを検証
email_bulk_validate	1 回のリクエストで最大 100 件のメールアドレスを検証
email_disposable_check	1 件のアドレスが使い捨て、無料、スパムリスト掲載、またはロールベースかどうかと、そのドメインにメールサーバーがあるかを確認
email_bulk_disposable_check	1 回のリクエストで最大 100 件のアドレスに使い捨てチェックを実行

---

電話番号検証（phone-validation）— 2 個のツール

通信事業者、回線種別、位置情報、標準化された形式を確認します。

ツール	説明
phone_validate	1 件の電話番号を検証
phone_bulk_validate	1 回のリクエストで最大 100 件の電話番号を検証

---

SSL（ssl）— 2 個のツール

あらゆるドメインのSSL証明書の最新データを取得します。

ツール	説明
ssl_live_lookup	ドメインの最新SSL証明書を取得します
ssl_live_chain_lookup	ドメインのSSL証明書チェーン全体を取得します

---

ドメイン（domain）— 6 個のツール

一括対応のドメイン利用可能状況チェック、候補の提案、サブドメインの検出、レピュテーション評価、タイポスクワッティング検索を行います。

ツール	説明
domain_check_availability	ドメイン名を登録できるか確認します
domain_check_availability_with_suggestions	利用可能状況を確認し、代替ドメインの候補を取得します
domain_subdomain_lookup	検出されたドメインのサブドメインをページ分割して一覧表示します
domain_bulk_check_availability	最大100個のドメインの利用可能状況を一度に確認します
domain_reputation_lookup	ドメインのリスク判定、信頼スコア、DGA、脅威フィード、メール配信到達性を確認します
domain_typosquatting_lookup	ブランドのキーワードまたはワイルドカードパターンに類似した、登録済みの誤字・類似ドメインを検索します

---

スクリーンショット（screenshot）— 3 個のツール

あらゆるウェブページのスクリーンショットやスクロール動画を撮影します。

ツール	説明
screenshot_capture	ウェブページのスクリーンショットを撮影し、画像URLを返します
screenshot_bulk_capture	1回のリクエストで最大50件のウェブページのスクリーンショットを撮影します
screenshot_capture_scrolling	ウェブページのスクロール動画またはアニメーションGIFを録画します

---

PDF（pdf）— 20 個のツール

PDFの結合、分割、ページの抽出・削除、画像への変換、テンプレートからの生成、圧縮、回転、暗号化・制限、復号・制限解除、ウェブ表示用の最適化を行います。

ジョブ（結合、分割、変換など）は非同期で実行され、taskIdを返します。pdf_task_statusで進行状況を確認してください。ローカルファイルには絶対パスが必要です（MCP サーバーがディスクを読み取ります）。保存済みのfile_idも指定できます。テンプレート生成（pdf_generate、pdf_generate_bulk）は同期処理で、ホストされたpdf_urlを返します。

完了したジョブにはダウンロードURLが含まれます。APIキーをapiKeyクエリパラメーターまたはX-apiKeyヘッダーとして追加してください。

ツール	説明
pdf_merge	PDFを結合します（ローカルパスおよび／または保存済みファイルID）
pdf_split	ページ範囲を指定してPDFを分割します
pdf_extract_pages	ページを抽出して新しいPDFまたはZIPを作成します
pdf_remove_pages	PDFからページを削除します
pdf_to_image	ページをPNG、JPG、TIFF、BMP、またはGIFに変換します
pdf_generate	JSONを使ってテンプレートをレンダリングし、ホストされたPDFのURLを取得します
pdf_generate_bulk	CSVの各行につき1つのPDFをレンダリングします
pdf_compress	PDFファイルのサイズを縮小します
pdf_rotate	ページを回転します
pdf_encrypt	PDFをパスワードで保護します
pdf_restrict	印刷、コピー、編集を制限します
pdf_decrypt	暗号化を解除します
pdf_unrestrict	権限制限を解除します
pdf_linearize	Fast Web View向けに最適化します
pdf_task_status	非同期ジョブ1件の状態（queued／processing／completed／failed）を確認します
pdf_file_status	保存済みファイルのメタデータを取得します
pdf_files	保存済みPDFを一覧表示します
pdf_file_delete	保存済みPDFを削除します
pdf_upload	ローカルPDFをアップロードしてファイルIDを取得します
pdf_upload_binary	大容量PDFを1つ、未加工のバイトデータとしてアップロードし、ファイルIDを取得します

---

通貨（currency）— 12 個のツール

170 種類以上の法定通貨と 830 種類以上の暗号資産に対応した、リアルタイムおよび過去の為替レートです。

ツール	説明
currency_latest_rates	対応するすべての通貨の最新為替レート
currency_historical_rates	指定した過去の日付の為替レート
currency_latest_converter	リアルタイムの為替レートを使用した通貨間の金額換算
currency_historical_converter	指定した過去の日付の為替レートを使用した換算
currency_time_series	任意の日付範囲における日ごとの為替レート
currency_fluctuation	指定期間の為替レート変動指標と変化率
currency_geo_convert	IP アドレスの国の現地通貨への換算
currency_supported	メタデータを含む、対応通貨の完全な一覧
currency_symbols	通貨記号と通貨名の対応表
currency_symbol_info	通貨記号を検証し、正式名称を取得
currency_historical_data_limits	各通貨の過去データの利用可能期間
currency_historical_data_limit_info	1 つの通貨コードの過去データの利用可能期間

---

コモディティ（commodity）— 7 個のツール

金属、エネルギー、農産物など、245 種類以上のコモディティのリアルタイムおよび過去の価格です。一部のシンボルを解決できない場合、API はリクエスト全体を失敗させず、unresolved マップを含む部分的な結果を返します。

ツール	説明
commodity_latest_rates	最新価格（シンボルごとの更新間隔）。オプションで建値通貨に換算
commodity_historical_rates	指定した日付の過去の OHLC 価格（1990 年以降。データがない場合は直前の利用可能な日付にフォールバック）
commodity_fluctuation	日付範囲内の開始／終了価格、絶対変動額、変化率（期間の長さに制限なし）
commodity_time_series	日付範囲内の日次 OHLC 価格（最大 365 日。取引のない日は除外）
commodity_symbols	各シンボルの更新間隔を含む、メタデータ付きの対応コモディティシンボル一覧
commodity_symbol_info	1 つのシンボルの情報を取得（更新頻度、ステータス、単位、通貨）
commodity_quotes	コモディティ価格の表示に対応するすべての通貨の一覧

---

金融（financial）— 9 個のツール

VAT 税率、VAT 番号の確認、IBAN の検証、SWIFT/BIC の検索に対応します。

ツール	説明
financial_vat_rates_by_country	国別の VAT 税率。オプションで州別に指定
financial_vat_rates_bulk	最大 100 か国／州の VAT 税率
financial_vat_rates_by_ip	IP アドレスから特定した国の VAT 税率
financial_vat_validate	EU（VIES）または英国（HMRC）の VAT 番号を検証
financial_iban_validate	IBAN を検証（形式、チェックサム、銀行／SEPA メタデータ）
financial_swift_lookup	8 桁または 11 桁の SWIFT/BIC コードの銀行詳細
financial_swift_finder	国 → 銀行 → 都市 → SWIFT/BIC コードの順に絞り込み
financial_supported_countries	VAT、IBAN、SWIFT API が対応する国（および VAT の州）
financial_supported_country_info	1 か国が VAT、IBAN、SWIFT のいずれかに対応しているかを確認

---

郵便番号（zipcode）— 7 個のツール

世界各地の郵便番号検索、半径検索、距離計算に対応します。

ツール	説明
zipcode_lookup	ZIP コードまたは郵便番号を検索 — 都市、地域、国、座標
zipcode_radius_search	中心地点から指定した半径内にあるすべての ZIP コードを検索
zipcode_distance	基準地点から最大 100 件の ZIP コードまでの距離を計算
zipcode_by_city	都市のすべての ZIP コード／郵便番号を取得
zipcode_bulk_lookup	最大 100 件の ZIP コード／郵便番号を一括検索
zipcode_distance_match	指定した距離のしきい値以内にあるすべての ZIP コードの組み合わせを検索
zipcode_by_region	州、省、地域のすべての ZIP コード／郵便番号を取得

---

天気（weather） — 9 個のツール

リアルタイムの気象状況、予報、過去のデータ、環境モニタリング、天文情報。

ツール	説明
weather_current	任意の場所の現在の天気 — 気温、湿度、風、気圧、AQI
weather_forecast	最大16日先までの予報。日単位、時間単位、分単位の精度を指定可能
weather_historical	過去の任意の日付の天気（1940年までさかのぼるデータ）
weather_time_series	カスタムの日付範囲における過去の天気
weather_air_quality	リアルタイムまたは予報の大気質指数と汚染物質の内訳
weather_marine	海洋気象情報。リアルタイムまたは最大16日先までの予報
weather_flood_forecast	河川流量と流量パーセンタイルデータを含む洪水予報
weather_bulk_current	1回のリクエストで最大50か所の現在の天気を取得
astronomy_lookup	日の出、日の入り、月相、薄明、ゴールデンアワー、南中、月の出、太陽と月の位置

---

地理（geography） — 10 個のツール

国、都市、行政区画、地域、旗画像。

ツール	説明
geodb_admin_levels	国の行政区画の階層
geodb_admin_units	国の州、省、その他の行政区画
geodb_admin_unit_details	1つの行政区画の詳細
geodb_countries	ISO コード、首都、地域を含む国の一覧
geodb_country_details	alpha-2 コードで指定した1か国のすべてのメタデータ
geodb_cities	国の都市。必要に応じて行政区画で絞り込み可能
geodb_regions	GeoDB の地域一覧（アフリカ、南北アメリカ、アジア、ヨーロッパ、オセアニア、極地）
geodb_subregions	小地域の一覧。必要に応じて地域で絞り込み可能
geodb_flags_supported	対応する国旗および組織旗の識別子
geodb_flag	国または組織の旗画像を取得

---

タイムゾーン（timezone） — 2 個のツール

任意の場所識別子を使ったタイムゾーンの検索と変換。

ツール	説明
timezone_lookup	場所のタイムゾーン情報 — IP、都市、緯度／経度、IATA、ICAO、UN/LOCODE を指定可能
timezone_convert	日時をあるタイムゾーンから別のタイムゾーンに変換

---

ユーザーエージェント（user-agent） — 2 個のツール

ユーザーエージェント文字列を解析して、ブラウザー、OS、デバイスの情報を抽出します。

ツール	説明
user_agent_parse	ユーザーエージェント文字列を解析 — ブラウザー、デバイス、OS、エンジン
user_agent_bulk_parse	1回のリクエストで最大20,000件のユーザーエージェント文字列を解析

---

サポート

• メール： [email protected]
• ステータス： status.apifreaks.com
• 問題： github.com/api-freaks/apifreaks-mcp/issues

---

ライセンス

このプロジェクトは、Apache License 2.0 の下でライセンスされています。ライセンスの条件に従って、このソフトウェアを自由に使用、変更、配布できます。

---

プライバシーポリシー

API リクエストは、APIFreaks のプライバシーポリシーに従って処理されます。データの収集および取り扱いの詳細については、apifreaks.com/privacy-policy をご覧ください。