> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Codeプラグイン

> Ayrshare Claude Codeプラグインをインストールして、エディタからソーシャル投稿の公開、スケジュール、分析を行えます。公開前検証、公開前確認プロンプト、ブランドボイスドラフト、analytics読み戻しをサポートします。

Ayrshare Claude Codeプラグインは、[MCPサーバー](/additional/mcp-action-server)の設定、セットアップコマンド、agent、skill、および安全性フックをバンドルしています。これをインストールすると、Claude Codeから直接投稿の公開、履歴やanalyticsの取得、プロフィール管理などが可能になります。何かがライブになる前に、agentは各投稿を対象ネットワークのルールに対して検証し、確認を求めるため、避けられる拒否を事前にキャッチできます。ブランドのボイスに合わせるための投稿履歴を利用でき、analyticsを読み戻すことで次の投稿に活かせます。

このプラグインはオープンソースです。内部については以下のリポジトリを参照してください: [ayrshare/ayrshare-social-media-api-claude-plugin](https://github.com/ayrshare/ayrshare-social-media-api-claude-plugin)。

## インストール

<Steps>
  <Step title="マーケットプレイスを追加（初回のみ）">
    ```bash theme={"system"}
    claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin
    ```
  </Step>

  <Step title="プラグインをインストール">
    ```bash theme={"system"}
    claude plugin install ayrshare@ayrshare
    ```
  </Step>
</Steps>

### インストールスコープ

| スコープ              | 適用範囲                       |
| ----------------- | -------------------------- |
| グローバル（デフォルト）      | このマシン上のすべてのプロジェクト。         |
| `--scope local`   | 現在のプロジェクトのみ、gitにコミットされない。  |
| `--scope project` | 現在のプロジェクト、コミットされチームと共有される。 |

<Note>
  Claude CodeのCLIでは、グローバルスコープを`--scope user`と呼びます。
</Note>

## 認証情報

Ayrshare APIキーは、以下のいずれかの方法で提供します:

<ul class="custom-bullets">
  <li>`/ayrshare:setup`を実行して、キーの設定またはローテーションを行います。</li>
  <li>`AYRSHARE_API_KEY`環境変数を設定します。</li>
</ul>

プラグインにバンドルされた`.mcp.json`には既に`Authorization`ヘッダーに加え、オプションの`Profile-Key`およびX BYOKヘッダーがそれぞれ空のデフォルト値（`${VAR:-}`）で宣言されているため、対応する環境変数を設定するだけでヘッダーを有効にできます（Claude Codeが起動時に値を置換します）。すべての呼び出しでサブプロフィールを対象にするには、`AYRSHARE_PROFILE_KEY`を（`/ayrshare:setup`または`settings.json`の`env`ブロックで）設定し、Claude Codeを再起動してください。バンドルされた`Profile-Key`ヘッダーがそれを運びます。未設定の場合は空のまま（未提供として扱われる）となります。単一の呼び出しでサブプロフィールを対象にするには、代わりに`profileKey`ツール引数を渡します（設定変更は不要）。バンドルされた`.mcp.json`を編集する必要はなく、また編集すべきではありません。なぜなら`claude plugin update`で上書きされるためです。

<Warning>
  MCPサーバーはセッション開始時に初期化されます。プラグインのインストール後やキーを変更した後は、**Claude Codeを再起動**してください。
</Warning>

### X/Twitter BYO認証情報

X/Twitterへの投稿には、独自のX Developer Appの認証情報が必要です（X BYOキー義務、2026年3月31日発効。[API概要](/apis/overview#xtwitter-byo-credentials)を参照）。バンドルされた`.mcp.json`には既に両方のX BYOKヘッダーが空のデフォルト値で宣言されており、`Authorization`および`Profile-Key`と並んで含まれています:

```json theme={"system"}
"headers": {
  "Authorization": "Bearer ${AYRSHARE_API_KEY}",
  "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}",
  "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}",
  "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}"
}
```

したがって、`/ayrshare:setup`または`settings.json`の`env`を介して対応する環境変数（`X_TWITTER_OAUTH1_API_KEY`、`X_TWITTER_OAUTH1_API_SECRET`）を設定するだけで、その後**Claude Codeを再起動**します。バンドルされた`.mcp.json`は編集しません（`claude plugin update`で上書きされます）。**両方**を設定するか、どちらも設定しないでください: どちらも設定されていない場合、X/Twitter呼び出しはエラー`419`（`x_credentials_required`）を返し、片方だけ設定されている場合はエラー`400`を返します。これはAyrshareアカウントごとに1つのキーペアで、Xを対象とするすべてのリクエストに送信されます（すべてのサブプロフィールで同じペア）。

<Note>
  プラグインよりも生の接続を好みますか？ 同じBYOヘッダーは`claude mcp add --header`で渡すこともできます — [接続とセットアップ → X/Twitter BYO認証情報](/additional/mcp-action-connect#xtwitter-byo-credentials)を参照してください。
</Note>

## 同梱されるもの

### コマンド

<ul class="custom-bullets">
  <li>`/ayrshare:setup` — Ayrshare APIキーの設定またはローテーションを行います。</li>
</ul>

### Agents

<ul class="custom-bullets">
  <li>`social-manager`: プラットフォーム全体でコンテンツを公開、スケジュール、分析します。</li>
  <li>`profile-manager`: プロフィールを作成・一覧表示し、Businessアカウントの下のクライアントプロフィール用のJWTソーシャルリンクURLを発行します。</li>
  <li>`insights-analyst`: 読み取り専用のレポーティング。メトリクスや投稿履歴を取得し、パフォーマンスを要約します。投稿、コメント、メッセージ送信、または変更は一切行いません。</li>
</ul>

### Skills

| Skill                        | 目的                                 |
| ---------------------------- | ---------------------------------- |
| `getting-started`            | 初回使用のためのオリエンテーションと接続。              |
| `post`                       | 投稿の作成、検証、更新、再試行。                   |
| `history`                    | 投稿およびプラットフォーム履歴の取得。                |
| `analytics`                  | 投稿ごとおよびアカウントレベルのanalyticsの取得。      |
| `comments`                   | コメントの読み取り、追加、および返信。                |
| `messages`                   | direct messageの読み取り、送信、および自動応答の設定。 |
| `profiles`                   | サブプロフィールの作成および一覧表示。                |
| `media`                      | メディアURLが到達可能であることを検証。              |
| `generate`                   | AIで投稿コピーをドラフトし、ハッシュタグを推奨。          |
| `webhooks`                   | webhookの登録、登録解除、および一覧表示。           |
| `errors`                     | Ayrshareエラーコードのデコード。               |
| `draft-in-brand-voice`       | 一貫したブランドボイスで投稿コピーをドラフト。            |
| `plan-and-schedule-campaign` | 複数投稿のキャンペーンを計画・スケジュール。             |

### 確認フック

`PreToolUse`フックは、公開または送信アクションの前に確認を求めます。以下の7つのツールを正確にカバーしています:

<ul class="custom-bullets">
  <li>`create_post`</li>
  <li>`update_post`</li>
  <li>`retry_post`</li>
  <li>`add_comment`</li>
  <li>`reply_comment`</li>
  <li>`send_message`</li>
  <li>`set_auto_response`</li>
</ul>

## FAQ

<AccordionGroup>
  <Accordion title="プラグインは公開前に投稿を検証しますか？">
    はい。プラグインは公開前に`validate_post`を実行して、コンテンツを各ネットワークのルール（長さ、フォーマット、メディア要件）に対してドライランするため、避けられる拒否を事前にキャッチできます。
  </Accordion>

  <Accordion title="ライブアカウントに投稿する前に確認しますか？">
    はい。`PreToolUse`確認フックが、公開または送信アクション（`create_post`、`update_post`、`retry_post`、`add_comment`、`reply_comment`、`send_message`、`set_auto_response`）の前に承認を求めます。
  </Accordion>

  <Accordion title="プラグインは私のブランドボイスに合わせられますか？">
    はい。`draft-in-brand-voice` skillは投稿履歴を読み取り、一貫したブランドボイスで新しいコピーをドラフトします。ドラフトを作成するだけで、確認なしに公開されるものはありません。
  </Accordion>

  <Accordion title="analyticsを読み取って次の投稿に活かせますか？">
    はい。analyticsツールは投稿ごとおよびアカウントレベルのメトリクスを返すため、結果を読み戻して次の投稿に活かせます。
  </Accordion>

  <Accordion title="プラグインを使うために何が必要ですか？">
    Ayrshare APIキー（プロフィールおよびサブプロフィール用にはBusinessプランキー）とClaude Code。キーは`/ayrshare:setup`または`AYRSHARE_API_KEY`環境変数で設定し、Claude Codeを再起動します。
  </Accordion>

  <Accordion title="X/Twitterへの投稿には追加設定が必要ですか？">
    はい。X/Twitterには独自のOAuth 1.0a認証情報が必要で、2つの接続ヘッダー（`X-Twitter-OAuth1-Api-Key`と`X-Twitter-OAuth1-Api-Secret`）として追加します。上記の[X/Twitter BYO認証情報](#xtwitter-byo-credentials)を参照してください。
  </Accordion>
</AccordionGroup>

## 次のステップ

<CardGroup cols={2}>
  <Card title="接続とセットアップ" icon="plug" href="/additional/mcp-action-connect" horizontal>
    認証、プロフィールターゲティング、およびBYO認証情報。
  </Card>

  <Card title="ツールカタログ" icon="list" href="/additional/mcp-action-tools" horizontal>
    ドメインごとにグループ化された27のツール、そのスコープと目的。
  </Card>
</CardGroup>