# Claude Code

> Claude Code または Claude Desktop に WayinVideo Skill をインストールし、自然言語プロンプトで動画のクリッピング、理解、要約、文字起こし、再利用を行います。

## Claude Code 連携

Claude Code で **WayinVideo Skill** を使うと、自然言語プロンプトから動画理解と AI クリッピングのワークフローを実行できます。

インストール後は、Claude Code に動画の分析、ショート動画向けのベストモーメント抽出、クリップ案の生成、TikTok、YouTube Shorts、Instagram Reels などのプラットフォーム向け出力の準備を依頼できます。

API request を手動で書くのではなく、会話形式で作業したい場合に便利です。Claude Code が Skill ワークフローを処理し、WayinVideo API が動画処理を実行します。

---

## できること

- 長い動画から、SNS 投稿に適したベストモーメントを切り出す。
- 自然言語の指示で動画内の特定モーメントを探す。
- 要約、ハイライト、タイトル、説明文、タグを生成する。
- Claude Code または Claude Desktop 内で WayinVideo API の機能を使う。
- 公開動画リンクを、API request を手動で作らずにショート動画ワークフローへ変換する。

---

## 始める前に

必要なもの：

1. Claude Code または Claude Desktop がインストールされていること。
2. [WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) で取得した WayinVideo API key。
3. アカウント残高に API Units があること。API を使う前に dashboard で API Units Package を購入し、利用可能な API Units を用意してください。

> API key は安全に管理してください。公開 repository、共有 transcript、client-side code に貼り付けないでください。

---

## WayinVideo Skill をインストールする

### Step 1: Skill Package をダウンロード

WayinVideo Skills ページにアクセスします：

[https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping](https://clawhub.ai/wayinvideo/video-understanding-and-ai-clipping)

skill package をダウンロードします。ZIP ファイルがローカルマシンに保存されます。

### Step 2: Claude Code に Skill をインストール

Claude Code を開き、次のプロンプトを入力します：

```text
install the skill from [the path of downloaded zip file]
```

`[the path of downloaded zip file]` を、ダウンロードした ZIP ファイルのローカルパスに置き換えてください。

例：

```text
install the skill from /Users/example/Downloads/wayinvideo-video-understanding-and-ai-clipping.zip
```

### Step 3: WayinVideo API Key を入力

インストールが完了すると、Claude Code が WayinVideo API key の入力を求めます。

API key はここで取得できます：

[https://wayin.ai/wayinvideo/api-dashboard](https://wayin.ai/wayinvideo/api-dashboard)

Skill を使う前に、アカウントに利用可能な API Units があることを確認してください。残高が空の場合は、まず dashboard で API Units Package を購入してください。

### Step 4: 求められた場合は Claude Desktop を再起動

Claude Desktop を使用している場合、Skill インストール後にアプリケーションが再起動を求めることがあります。

アプリケーションの指示に従い、求められた場合は再起動してください。再起動後、WayinVideo Skill を使用できます。

---

## 最初のプロンプトを試す

Skill のインストール後は、次のようなプロンプトから始められます：

```text
Use /wayinvideo to clip the best moments from this video. I want to post them on TikTok: [a youtube video link]
```

`[a youtube video link]` を処理したい動画 URL に置き換えてください。

Claude Code は WayinVideo Skill を使って動画を送信・処理し、リクエストに応じてクリップ候補または生成されたクリップを返します。

---

## その他のプロンプト例

### TikTok 向けクリップ候補を作る

```text
Use /wayinvideo to find 5 high-energy moments from this YouTube video for TikTok. Include titles, descriptions, and hashtags: https://www.youtube.com/watch?v=example
```

### 製品デモのモーメントを探す

```text
Use /wayinvideo to find moments where the speaker explains the product features. Return timestamps and short descriptions: https://www.youtube.com/watch?v=example
```

### 長い動画を要約する

```text
Use /wayinvideo to summarize this video and list the most important highlights: https://www.youtube.com/watch?v=example
```

### SNS 公開向けクリップを生成する

```text
Use /wayinvideo to create short clips from this video for YouTube Shorts and TikTok. Prefer vertical clips and include captions: https://www.youtube.com/watch?v=example
```

---

## 関連ドキュメント

その他の例と完全な Skill ドキュメントはこちら：

[動画理解 & AI クリッピング Skill](https://wayin.ai/ja/api-docs/skills-video-understanding-and-ai-clipping/)

以下の API ドキュメントも役立ちます：

| 目的 | ドキュメント |
| ---- | ------------ |
| 長い動画をショートクリップに変換する | [AI クリッピング API](https://wayin.ai/ja/api-docs/ai-clipping/) |
| 自然言語の指示でモーメントを探す | [モーメント検索 API](https://wayin.ai/ja/api-docs/find-moments/) |
| 構造化された動画要約を生成する | [動画要約 API](https://wayin.ai/ja/api-docs/video-summarization/) |
| タイムスタンプ付きの文字起こしを作成する | [動画文字起こし API](https://wayin.ai/ja/api-docs/video-transcription/) |
| 選択したクリップをレンダリングまたは再エクスポートする | [Clips Export API](https://wayin.ai/ja/api-docs/clips-export/) |
| クリップをソーシャルメディアアカウントへ公開する | [ソーシャルメディア公開 API](https://wayin.ai/ja/api-docs/social-media-publishing/) |
| 課金と API Units を理解する | [Pricing](https://wayin.ai/ja/api-docs/pricing/) |

---

## トラブルシューティング

### Claude Code が `/wayinvideo` を認識しない

Skill のインストールが正常に完了したことを確認してください。Claude Desktop を使用していて再起動を求められた場合は、アプリケーションを再起動してからもう一度試してください。

### Claude Code が再度 API Key を求める

[API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) で取得した WayinVideo API key を入力してください。最近 key をローテーションした場合は、新しい key を使用してください。

### API Request が API Units のため失敗する

[WayinVideo API Dashboard](https://wayin.ai/wayinvideo/api-dashboard) で API Units 残高を確認してください。残高が空の場合は、API を使う前に API Units Package を購入してください。