CLI & API

AI ツール連携

以下のスキルファイルを ~/.claude/skills/mimicry/SKILL.md に配置すると、Claude Code が HTTP トラフィックに関する質問に対して自動的に mimicry CLI を呼び出してトラフィック分析を行います。

「どの API を叩いているか調べて」「404 が出ているリクエストを探して」「このドメインのモックを作って」 のような依頼が自動的にスキルのトリガーになります。 他の AI コーディングツールからも REST API / CLI 経由で同様に操作可能です。

---
name: mimicry
description: >
  Mimicry HTTP/HTTPS プロキシツールを CLI 経由で操作する。
  iOS/Android アプリ開発中のトラフィック確認・分析、モックルール生成、ログ保存を自動化する。
  「Mimicry でトラフィックを確認して」「どの API を叩いているか調べて」「ログからモックを作って」
  「レスポンスボディを見せて」「このドメインのエンドポイントは？」「404 が出ているリクエストを調べて」など、
  HTTP トラフィックやプロキシログに関する依頼には積極的にこのスキルを使う。
  ユーザーが "Mimicry" と明示しなくても、アプリの通信内容・API レスポンス・ネットワークログに関する調査依頼にも適用する。
user-invocable: false
---

# Mimicry CLI 操作ガイド

Mimicry はアプリ起動中の HTTP/HTTPS トラフィックをキャプチャするプロキシツール。
CLI (`mimicry`) を使うことで、GUI を操作せずにトラフィック確認・ログ検索・モック生成を自動化できる。

**前提**: Mimicry GUI アプリが起動済みであること。
未起動の場合は `open -a Mimicry` で起動を促してから作業を進める。

## コマンドリファレンス

```bash
# 状態・概要
mimicry status                              # プロキシ稼働状態とログ件数を確認
mimicry domains                             # キャプチャ済みドメイン一覧
mimicry endpoints <ドメイン>                # 特定ドメインのエンドポイント一覧

# ログ検索
mimicry logs                                # 最近 50 件を一覧
mimicry logs --domain <ドメイン>            # ドメインでフィルター
mimicry logs --method POST --limit 20       # HTTP メソッドでフィルター
mimicry logs --status-code 404              # ステータスコードでフィルター
mimicry logs --url "*/users/*"              # URL パターン（glob）でフィルター
mimicry logs clear                          # ログを全消去

# 詳細確認（logs で取得した ID を使う）
mimicry log <id>                            # リクエスト／レスポンスのヘッダーや詳細
mimicry log <id> --body                     # レスポンスボディを表示

# 保存・モック生成
mimicry save <出力パス>.har                 # ログを .har ファイルに保存
mimicry save <出力パス>.har --domain <ドメイン>
mimicry mock                                # 全ログからモックルール生成
mimicry mock --domain <ドメイン>            # ドメイン限定でモックルール生成

# curl コマンド生成
mimicry curl <id>                           # 通信を再現する curl コマンドを出力

# ログ追加オプション
mimicry logs --watch                        # 新着ログを tail -f モードで表示
mimicry logs --reverse                      # 古い順で表示
mimicry logs --count-only                   # 件数のみ出力
mimicry logs --fields method,status,url     # 出力フィールドを選択

# 録画追加コマンド
mimicry recording list-devices              # 録画対象デバイス一覧
mimicry recording start --video-device <id> # 画面録画付き録画
mimicry recording status                    # 録画状態確認
mimicry recording show <id>                 # 録画詳細
mimicry recording delete <id>               # 録画削除
mimicry recording playback-status           # 再生状態確認

# シェル補完
mimicry completions <shell>                 # シェル補完スクリプト生成 (bash/zsh/fish)

# スタンドアロンサーバー
mimicry serve --rules <file> [options]      # GUI 不要のプロキシサーバー起動
```

## 目的別ワークフロー

### 通信全体を把握したい

```bash
mimicry status
mimicry domains
mimicry endpoints <ドメイン>
```

### API レスポンスを調べたい

```bash
mimicry logs --domain <ドメイン> --limit 10
mimicry log <id>
mimicry log <id> --body
```

### エラーを追いたい

```bash
mimicry logs --status-code 500
mimicry logs --url "*/auth/*" --status-code 401
```

### テスト用モックを作りたい

```bash
mimicry mock --domain <対象ドメイン>
# → 出力されたファイルを Mimicry GUI でインポート
```

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

| 症状 | 対処 |
|------|------|
| Cannot connect to Mimicry app. | `open -a Mimicry` で起動 |
| ログが 0 件 | アプリを操作してからリトライ |
| 指定した ID が見つからない | `mimicry logs` で最新 ID を確認 |