# はじめに

アカウントの作成から、「次に何を書くべきか」をエージェントに相談できる状態になるまでの手順を説明します。

## エージェントにセットアップを任せる

登録が済んだら、Claude、ChatGPTなど、ご利用のMCPクライアントに次の1行を貼り付けます。

```
https://kafkai.com/ja/docs/onboarding.md を読んで、Kafkaiのセットアップを進めてください。
```

エージェントが[エージェント向けの手順書](https://kafkai.com/ja/docs/onboarding/)を読み、利用中のクライアントに合った接続手順を案内します。接続後は、最初のプロジェクトの作成まで進めます。クレジットを消費する呼び出しの前には、エージェントが必ず消費するクレジット数を伝えます。

エージェントがWebページを開けない場合は、以下の手順で進めます。

## 1. アカウントを作成する

[登録ページ](https://kafkai.com/ja/register/)でアカウントを作成し、メールアドレスを確認します。データを返すツールの呼び出しにはクレジットが必要です。ダッシュボードで残高を確認し、不足していれば[料金ページ](https://kafkai.com/ja/pricing/)でパックを購入します。なお、新規アカウントに無償クレジットを付与することがあります。付与する場合は、数量と有効期限をそのときにお知らせします。

## 2. ダッシュボードを開く

サインイン後の[ダッシュボード](https://kafkai.com/ja/app/)に、接続に必要な情報がまとまっています。

- クライアントに貼り付けるMCPサーバーのURL
- APIトークン（ヘッダー認証を使うクライアント向け）
- クレジット残高と利用履歴

## 3. エージェントを接続する

ご利用のクライアントに応じて、接続手順のページに進みます。

- [Claudeと接続する](https://kafkai.com/ja/docs/connect-claude/)
- [ChatGPTと接続する](https://kafkai.com/ja/docs/connect-chatgpt/)
- [Hermes・その他のクライアント](https://kafkai.com/ja/docs/connect-hermes/)

接続が完了すると、エージェントのツール一覧に `kafkai_` で始まるツールが表示されます。

## 4. 最初のプロジェクトを作成する

プロジェクトは、エージェントとの会話からそのまま作成できます。

> https://hogehoge.jp のKafkaiプロジェクトを日本市場で作成して。
> 競合には https://competitor-a.com と https://competitor-b.com を
> 追加して。

対象の国は必ず伝えます。プロジェクトは1つの国の検索結果に固定されるため、Kafkaiは国を推測しません。指定がない場合は課金されずにエラーとなり、選択できる市場の一覧を返します。

エージェントが `kafkai_create_project` を呼び出し、Kafkaiがバックグラウンドでキーワード調査を開始します。調査には数分かかります。進捗もエージェントに確認できます。

> hogehoge.jp プロジェクトの概要を教えて。

キーワード数が0のままであれば、調査はまだ実行中です。数分待ってから、もう一度確認します。

## 5. 次に書くテーマを相談する

調査が完了したら、次のような質問から始めると効果的です。

> hogehoge.jp で次に狙うべきキーワードは？理由も教えて。

> hogehoge.jp のキャッチアップキーワードから有望なものを1つ
> 選んで、Webで調べたうえで記事の下書きを
> 作って。

> competitor-a.com はどの領域で優位に立っている？差を埋めるには
> 何を公開すべき？

エージェントは、必要なツールを自動的に順に呼び出します。プロジェクト一覧、プロジェクト概要、推奨戦略のキーワード、の順に読み取り、そのあとWeb検索と執筆に進みます。各ツールの応答には `next_step_suggestion`（次の手順の提案）が含まれるため、特別なプロンプトは必要ありません。

ほかの質問例は[プロンプト例](https://kafkai.com/ja/prompts/)にまとめています。例ごとに、エージェントが呼び出すツールと、返ってくる結果を示しています。

## 6. 順位の変化を確認する

Kafkaiが計測した順位には、すべて計測日時が付きます。そのため、現在の順位と数か月前の順位を比較できます。

順位の更新は、指示したときだけ実行されます。データが古くなったら、更新を指示します。

> hogehoge.jp のキーワード順位を更新して。

比較には、2回以上の更新が必要です。2回目以降は、次のような質問ができます。

> hogehoge.jp で直近3か月に何が動いた？失ったキーワードはどれ？

> competitor-a.com が順位を落としているキーワードは？
> そのうち記事にすべきものはどれ？

どちらも `kafkai_get_ranking_changes` を呼び出します。このツールは変化の大きい順に並べ、比較した順位それぞれの計測日時も返します。

## 費用の目安

データを返すツールの呼び出しは、前払いのクレジット残高から消費します。残高の確認は無料です。「Kafkaiのクレジット残高は？」といつでも質問できます。詳しくは[クレジットと料金](https://kafkai.com/ja/docs/credits/)をご覧ください。
