Frase SEO

@frase/mcp-server

このリポジトリについて — Frase MCP サーバーの公開リポジトリです。ドキュメント、レジストリメタデータ（server.json）、変更履歴、コネクターのセットアップを掲載しています。サーバーは Frase のプライベートモノレポで開発され、npm では @frase/mcp-server として公開されています。ホスト型リモートサーバー（OAuth）は https://next.frase.io/api/mcp で稼働しています。問題や機能リクエストはこちらからお寄せください。

Claude を使って Frase アカウントを操作できます。この MCP（Model Context Protocol）サーバーは、Frase の API をツールとして公開し、Claude が SEO/GEO コンテンツの作成、調査、最適化、AI Visibility の追跡などを支援できるようにします。Claude Desktop と Claude Code の両方で動作します。

MCP とは？

Model Context Protocol（MCP）は、Claude などの AI アシスタントが外部のツールやデータソースに安全に接続できるオープンスタンダードです。このサーバーは MCP を実装し、Claude が Frase アカウントにアクセスできるようにします。

ホスト型リモートサーバー（OAuth）

セットアップ不要で使いたい場合は、Frase がホスト型 MCP サーバーを https://next.frase.io/api/mcp（OAuth を使用したストリーミング可能な HTTP）で提供しています。リモート MCP サーバーに対応したクライアントは、URL で接続し、ブラウザーで Frase アカウントにサインインします。API キーもローカルへのインストールも不要で、更新は自動的に適用されます。

• Claude.ai / Claude Desktop：公式 Frase コネクターを開き、Frase アカウントに接続してください。
• Claude Code：

claude mcp add --transport http frase https://next.frase.io/api/mcp

以下のオプションでは、API キーを使用して stdio 経由でサーバーをローカル実行します。

クイックスタート

Claude Code：Claude Code（CLI）

次のコマンドを 1 つ実行して、Frase MCP サーバーを Claude Code に追加します。

claude mcp add frase -- npx -y @frase/mcp-server --api-key sk_live_your_api_key_here

Claude Code は必要に応じてサーバーを自動的に起動します。

手動セットアップ（npx、上級者向け）

1. API キーを取得する

Frase Settings から API キーを取得します。

2. Claude Desktop を設定する

次の内容を Claude Desktop の設定ファイルに追加します。

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

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

3. Claude Desktop を再起動する

設定を保存した後、Claude Desktop を再起動します。MCP サーバーの一覧に「frase」が表示されます。

Cursor

プロジェクトの .cursor/mcp.json に追加します。

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

オプション E：Windsurf

Windsurf の MCP 設定（~/.codeium/windsurf/mcp_config.json）に追加します。

{
  "mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

オプション F：GitHub Copilot を使用した VS Code

VS Code の設定（.vscode/settings.json）に追加します。

{
  "github.copilot.chat.mcpServers": {
    "frase": {
      "command": "npx",
      "args": ["-y", "@frase/mcp-server"],
      "env": {
        "FRASE_API_KEY": "sk_live_your_api_key_here"
      }
    }
  }
}

利用可能なツール

サイト

• list_sites - アカウント内のすべてのサイトを一覧表示します
• create_site - 追跡する新しいサイトを作成します

ブリーフ

• list_briefs - 任意のステータスフィルターを指定して、コンテンツブリーフを一覧表示します
• create_brief - 新しいブリーフを作成します（アウトラインの自動生成は任意です）
• get_brief - アウトラインと SERP データを含むブリーフの詳細を取得します
• get_brief_status - ブリーフの生成状況を確認します
• export_brief - ブリーフを JSON または Markdown 形式でエクスポートします

コンテンツ

• list_content - 任意のステータスフィルターを指定して、コンテンツ項目を一覧表示します
• get_content - 本文全体を含むコンテンツの詳細を取得します
• generate_content - ブリーフからコンテンツを生成します
• update_content - コンテンツのタイトル、本文、ステータス、またはメタタグを更新します
• delete_content - コンテンツ項目を削除します（論理削除）
• get_content_status - コンテンツの生成状況を確認します
• export_content - コンテンツを JSON、HTML、または Markdown 形式でエクスポートします
• regenerate_content - 任意の指示を指定して、コンテンツを再生成または改善します
• generate_hero_image - 既存の記事を再生成せずに、AI ヒーロー画像を生成して記事に添付します
• rescore_content - コンテンツの SEO、GEO、EEAT スコアを再計算します

リサーチ

• list_research - リサーチセッションの一覧を表示
• start_research - トピックに関する新しい AI を活用したリサーチを開始（タイプ：topic、competitor、gap、serp）
• get_research - 調査結果と情報源を含むリサーチの詳細を取得
• delete_research - リサーチセッションを削除
• export_research - リサーチ結果を JSON または Markdown 形式でエクスポート

ジョブ

• get_job_status - 非同期ジョブ（ブリーフ、リサーチ、監査、コンテンツなど）のステータスを確認

監査

• list_audits - サイト監査の一覧を表示
• start_audit - 新しいサイト監査を開始（full、technical、content、quick のいずれか）
• get_audit - ページと問題点を含む監査の詳細を取得
• export_audit - 監査データを JSON または CSV 形式でエクスポート
• audit_page - 単一のページ URL を対象に E-E-A-T、GEO、SEO のスコアを監査

SERP 分析

• analyze_serp - 検索クエリの検索エンジン結果を分析
• analyze_competitors - 検索クエリに関する競合他社のコンテンツを分析
• get_search_intent - 検索クエリの検索意図の分類を取得

AI の可視性

• get_ai_visibility - AI の可視性に関する概要指標を取得
• list_prompts - 監視対象の AI プロンプトを一覧表示
• create_prompt - 監視対象の新しいプロンプトを作成します。ロケーションを省略すると、サイトの国がデフォルトで設定されます（site_id を渡してください）。同じプロンプトはサイトごとに 1 回だけ追跡できます。
• get_prompt - 引用と結果を含むプロンプトの詳細を取得
• update_prompt - 監視対象のプロンプトを更新
• get_competitors - AI の可視性に関する競合他社を取得
• get_alerts - AI の可視性に関するアラートを取得
• get_insights - AI の可視性に関するインサイトと推奨事項を取得
• get_crawler_logs - サイト上での AI ボットのクロール状況を表示

アナリティクス

• get_gsc_overview - Google Search Console の概要指標を取得
• get_gsc_queries - GSC から検索クエリの上位を取得
• get_gsc_pages - GSC からパフォーマンスの高いページを取得
• get_content_gaps - コンテンツのギャップに関する機会を取得
• list_performance_alerts - パフォーマンスアラート（トラフィックの減少、ランキングの変動）を一覧表示
• resolve_alert - パフォーマンスアラートを解決済みとしてマーク

最適化

• list_optimizations - 最適化セッションの一覧を表示
• start_optimization - コンテンツの最適化分析を開始
• get_optimization - 提案を含む最適化の詳細を取得
• apply_optimization - 最適化の提案を適用
• get_optimization_insights - コンテンツ全体の最適化に関するインサイトを取得
• dismiss_optimization - 最適化を却下

Webhook

• list_webhooks - 設定済みの Webhook を一覧表示

Webhook の管理は、ホスト型リモートサーバーでのみ利用できます — write_webhook（作成／更新）、get_webhook、delete_webhook。クライアントが名前を指定して呼び出す場合は、stdio 経由でも引き続き実行されます。異なるのは一覧表示だけです。 エージェントに Webhook を検出させたい場合は、ホスト型エンドポイントに接続してください。

CMS への公開

• publish_content - Frase CMS または接続済みプラットフォームにコンテンツを公開
• list_cms_connections - サイトの CMS 接続ステータスを一覧表示

会話の例

サイトを一覧表示

You: What sites do I have connected?
Claude: [Uses list_sites tool]

Here are your connected sites:

| ID | Name | Domain | GSC | Created |
|----|------|--------|-----|---------|
| site_abc | Main Blog | example.com | Yes | Jan 15, 2024 |
| site_def | Product Site | product.example.com | No | Feb 20, 2024 |

リサーチからブリーフを作成

You: Create a brief about React performance optimization
Claude: [Runs start_research, waits for completion, then uses create_brief with the research_session_id]

## Brief Created

- **ID:** brief_abc123
- **Topic:** React performance optimization
- **Status:** pending

**Outline generation started.** Let me check the status...

[Uses get_job_status]

The outline is ready! Let me get the details...

[Uses get_brief]

## Brief: React performance optimization

### Outline
- Introduction to React Performance
- Common Performance Bottlenecks
- Optimization Techniques
- Measuring Performance
- ...

トピックをリサーチ

You: Research best practices for Next.js SEO
Claude: [Uses start_research]

## Research Started

- **ID:** res_xyz789
- **Query:** best practices for Next.js SEO
- **Type:** topic
- **Status:** pending

I'll check on the progress...

MCP リソース

Claude で Frase のデータを直接参照できます。

• frase://sites - すべてのサイトを一覧表示
• frase://sites/{id} - 個々のサイトの詳細を表示
• frase://content - すべてのコンテンツ項目を一覧表示
• frase://content/{id} - 本文全体を含むコンテンツを表示
• frase://briefs - すべてのブリーフを一覧表示
• frase://briefs/{id} - アウトラインを含むブリーフを表示

MCP プロンプト

一般的な SEO タスク向けの事前構築済みワークフローです。

プロンプト	説明
create_seo_article	完全なワークフロー：調査、ブリーフ作成、アウトライン作成、コンテンツ生成
optimize_content	コンテンツを分析し、最適化の提案を適用します
keyword_research	キーワード調査、SERP 分析、コンテンツ機会の調査
competitor_analysis	競合コンテンツを分析し、ギャップを見つけます
content_audit	サイト監査を実行し、改善の優先順位を付けます
content_pipeline	コンテンツのライフサイクル全体を自律的に実行します：調査、ブリーフ作成、執筆、最適化、公開
content_watchdog	パフォーマンスを監視し、ランキング低下に対処して、成果の低いコンテンツを再最適化します

設定

変数	必須	説明
FRASE_API_KEY	はい	Frase API キー
FRASE_API_URL	いいえ	API URL を上書きします（デフォルト：https://next.frase.io/api/v1）

トラブルシューティング

Claude Desktop にサーバーが表示されない

1. 設定ファイルの場所を確認します。

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

2. JSON の構文を確認します。必要に応じてバリデーターを使用してください。

3. Claude Desktop を完全に再起動します（終了してから再度開きます）。

Claude Code でサーバーが動作しない

1. サーバーが登録されていることを確認します：claude mcp list
2. サーバーのステータスを確認します：claude mcp status frase
3. 必要に応じて削除し、再追加します：claude mcp remove frase

認証エラー

• API キーが正しいことを確認します
• キーの有効期限が切れていないことを確認します
• キーに必要な権限があることを確認します

レート制限

サーバーは指数バックオフを使用してレート制限時に再試行するため、1 分間に発生する短時間の集中リクエストに対処できます。

3 つの制限がそれぞれ独立して適用されます：1 分あたりのバースト制限、継続的な 1 時間あたりの上限、月間リクエスト予算です。再試行が有効なのは最初の制限だけです。1 時間あたりの上限に対する 429 には最大 1 時間の Retry-After が設定され、指定時間より早く再試行しても成功しません。エラーの code を確認して区別してください：rate_limit_exceeded（バースト、短時間待って再試行）、hourly_limit_exceeded（Retry-After まで待機）、monthly_budget_exceeded（アップグレードするか、次のサイクルまで待機）。

サポート

• Frase ドキュメント
• API ドキュメント
• GitHub の Issue
• メール：[email protected]

プライバシーポリシー

Frase プライバシーポリシー

このサーバーはお客様の Frase アカウントに接続し、お客様が行うリクエストを Frase API に送信します。以下に記載するツール呼び出しのテレメトリー以外に 独自のデータを収集することはなく、会話履歴、ファイル、メモリを読み取ることもありません。

• 収集する情報 — 各ツール呼び出しについて、Frase の組織 ID と ユーザー ID（または API キー ID）、ツール名、引数の SHA-256 ハッシュ（引数そのものでは ありません）、引数のサイズ（バイト単位）、呼び出しにかかった時間、 成功したかどうか、失敗した場合のエラーの種類、タイムスタンプを収集します。これらの情報は 監査と信頼性の向上に使用されます。
• 収集しない情報 — 会話内容、プロンプト、読み取り可能な形式の引数の値。
• 保管と保持期間 — テレメトリーはお客様の Frase 組織に紐づけて保管され、上記のプライバシーポリシーに記載された保持条件に従って保持されます。
• 第三者との共有 — プライバシーポリシーに記載されたサブプロセッサーを除き、共有しません。
• 削除 — データの削除を依頼するには、[email protected] までメールでご連絡ください。

ライセンス

MIT