> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/ja/readme.md).

# Squish

**AIに動画へのランダムアクセスを与えます。** モデルにクリップを最初から最後まで見せるのではなく、Squish は連続した動画を **アドレス可能な視覚表現** に変換します。これはエージェントが移動し、再訪し、段階的に洗練できるものです。タイムスタンプ付きコンタクトシートは、その *最初の実装* です。各セルに絶対タイムコードが付いたフレームのグリッドです。CLI と MCP サーバーはすべてお使いのマシン上で実行されます。

> **エージェントは動画を消費するのではなく、動画をたどります。** 実際の実行例: シーンのカットを **0.2 秒** で特定し、 **3,088 フレームではなく 34 フレーム** を取得します（全体把握 → 拡大 → 拡大）。

## このデモがそのプリミティブです

コンタクトシートについての 76 秒の解説動画と、同じ動画を *として* 1 枚のコンタクトシートとして表したものです。片方は再生ボタンが必要ですが、もう片方は読むだけです:

* [**▶ 視聴** — 76 秒、直線的](https://getsquish.app/assets/content/smart-contact-sheets.mp4)
* [**読む** — 同じ動画を 3×3 のタイムスタンプ付きコンタクトシート 1 枚として表したもので、ランダムアクセスが可能です](https://getsquish.app/assets/content/smart-contact-sheets-3x3.jpg)

## これが機能する理由

動画は連続的ですが、推論は疎です。ほとんどの質問はタイムラインのごく一部にしか関係しません。Squish はそのタイムラインをアドレス可能な地図に変換するので、エージェントは **すべてを再生し直すのではなく、必要な視覚的証拠を取得します** — コンタクトシートは出力ではなく、ナビゲーション層です。

{% hint style="info" %}
**AI アシスタント向けです。** このサイトでは `/llms.txt` と `/llms-full.txt`を提供しています。任意のページ URL の末尾に `.md` を付けると、元の Markdown を取得できます。これらのドキュメント用の MCP サーバーはサイトルートと `/~gitbook/mcp`.
{% endhint %}

## 始め方

同じエンジンを実行する 4 つの方法があります:

| パス           | 内容                                                                                                       | ここから始める                                                    |
| ------------ | -------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **CLI**      | `npx -y @getsquish/squish clip.mov` — シートは入力ファイルの横に出力されます。ローカルで、無料で、あらゆる密度で制限なしです。                       | [CLI クイックスタート](/squish/ja/hajimeni/quickstart-cli.md)      |
| **MCP サーバー** | 1 つのツール、 `squish_video` — エージェントがローカルのクリップを自分で Squish にかけ、ビジョンで読み取ります。ローカルで、無料で、あらゆる密度で制限なしです。           | [MCP クイックスタート](/squish/ja/hajimeni/quickstart-mcp.md)      |
| **リモート MCP** | ホスト型コネクタ URL として同じツールを提供します。ローカルツールのない公式 AI アプリ向けです。公開動画の URL を指定すると、Squish のサーバーが取得して処理します。インストールは不要です。 | [リモート MCP エンドポイント](/squish/ja/rifarensu/remote-mcp.md)     |
| **ホスト型 API** | `POST /v1/squish` — CI、サーバーレス、ffmpeg のないマシン向けの意図的なアップロードです。前払いクレジットあり、未課金アカウントは毎日の無料枠があります。              | [ホスト型 API クイックスタート](/squish/ja/hajimeni/quickstart-api.md) |

どの面を呼び出すか、シートが返ってきたらどう振る舞うかを判断するエージェントは、1 ページで全体像を把握できます: [AI エージェント向け](/squish/ja/hajimeni/for-ai-agents.md).

その *理由* — 動画をアドレス空間として扱うとはどういうことか、そしてその上に構築されたナビゲーションループについては、 [アドレス空間としての動画](/squish/ja/purimitibu/video-as-address-space.md). 正確な契約内容 — CLI フラグ、MCP ツールスキーマ、HTTP エラー、シートの構成 — については、 [リファレンス セクション](/squish/ja/rifarensu/cli.md).

## 一言でいうプライバシー

CLI と MCP サーバーはすべてを **お使いのマシン上で** 処理します — 何もアップロードされません。例外的に、2 つの経路では意図的にメディアが Squish のインフラを通ります。ホスト型 API（クリップをアップロードします）とリモート MCP エンドポイント（サーバーが公開 URL を取得します）です。どちらの場合も、動画はジョブ終了と同時に削除され、出力シートは一時 URL に保存されます。全体像: [プライバシーとデータフロー](/squish/ja/purimitibu/privacy-and-data-flow.md).

***

Apache-2.0 · [getsquish.app](https://getsquish.app) · ソース: [github.com/getsquish/squish](https://github.com/getsquish/squish) · パッケージ: [`@getsquish/squish`](https://www.npmjs.com/package/@getsquish/squish)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/ja/readme.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.