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

# ブラウザ拡張機能を使う

> Linkly AI Clipper：ワンクリックでウェブページを整ったレイアウトの Markdown に変換。サイドパネルでプレビュー・コピー・ダウンロードでき、Linkly AI スペースへ直接保存することもできます。

## 何ができるのか

**Linkly AI Clipper** は Linkly AI のブラウザ拡張機能で、やることはたった 1 つです：**ウェブページを Agent が読みやすい Markdown として保存する**こと。

ワンクリックで今見ているページを整ったレイアウトの Markdown に変換し、サイドパネルでプレビュー・コピー・ローカルへのダウンロードができます。単なる「ウェブページの保存」ではありません —— 本文、画像、訳文、動画の字幕、そしてあなたと AI の会話まで、すべてが 1 つのきれいな、Agent がそのまま使える Markdown ファイルになります。

<CardGroup cols={2}>
  <Card title="保存した時点で Agent が読める形式" icon="file-code" iconType="duotone">
    YAML のフロントマターと明確な見出し構造付き。X や Weibo などのサイトは個別に最適化しています
  </Card>

  <Card title="そのまま Linkly AI スペースへ" icon="folder-tree" iconType="duotone">
    デスクトップアプリを入れていれば、クリップはそのまま Linkly AI スペースに入り、パソコン上の他のファイルと一緒にインデックスされます
  </Card>

  <Card title="画像も一緒に" icon="image" iconType="duotone">
    本文中の画像は同じフォルダにダウンロードされるので、オフラインでも文章と画像をそのまま読めます
  </Card>

  <Card title="すべてブラウザ内で完結" icon="shield-check" iconType="duotone">
    抽出・翻訳・目次生成はすべてお使いのブラウザ内で行われ、当社のサーバーを経由しません
  </Card>
</CardGroup>

<Note>**拡張機能の表示言語は現在、英語と簡体字中国語だけです。**日本語環境のブラウザでは英語で表示されます。そのため、このページで触れるボタン名や設定項目名は、実際に画面に出る**英語のまま**記載し、括弧内に日本語訳を添えています。デスクトップアプリとウェブ側は日本語化されているので、そちらの画面名は日本語で記載しています。</Note>

***

## インストール

Chrome ウェブストアからインストールします：[**Linkly AI Clipper**](https://chromewebstore.google.com/detail/linkly-ai-clipper/akplbgdjkgkakgoemhpjpphfilipdbda)。

| 項目            | 要件                                                           |
| ------------- | ------------------------------------------------------------ |
| **ブラウザ**      | Chrome 116 以降（サイドパネル API に必要です）                              |
| **端末内 AI 機能** | ローカル翻訳と AI による目次補完には新しめの Chrome が必要です（内蔵モデルが使えれば OK）         |
| **その他のブラウザ**  | Edge、Brave などの Chromium 系ブラウザは Chrome ウェブストアからそのままインストールできます |
| **ログイン / 料金** | どちらも不要です。[よくある質問](#よくある質問)をご覧ください                            |

<Warning>\*\*Firefox は現在サポートしていません。\*\*拡張機能は Chrome ウェブストアにのみ公開しており、Firefox 版はリリースしていません。Firefox のアドオンサイトで探さないでください。</Warning>

***

## 最初のページをクリップする

<Steps>
  <Step title="記事のページを開く">
    記事でも、ポスト 1 件でも、Q\&A の回答でも、YouTube の動画ページでも構いません。適当に 1 つ開いてください。
  </Step>

  <Step title="ツールバーの L アイコンをクリック">
    ブラウザ右上の拡張機能アイコンをクリックすると、右側にサイドパネルが開き、現在のページの本文を自動的に抽出して Markdown に変換し始めます。

    <Note>
      \*\*コンテキストメニューもキーボードショートカットもありません。\*\*サイドパネルを開く方法はツールバーのアイコンをクリックすることだけです。拡張機能をツールバーにピン留めしておくことをお勧めします（拡張機能メニューのピンアイコンをクリック）。
    </Note>
  </Step>

  <Step title="結果を確認して、コピーまたは保存する">
    既定は **Preview**（プレビュー）ビュー —— レイアウトの整った読書用の画面です。ツールバーにはほかに「**Edit source**」（生の Markdown に切り替えて直接編集）、「**Metadata**」（取得元の URL / サイト / 著者 / 公開日時）、「**Table of contents**」（目次）、そして 4 段階の文字サイズ調整があります。

    問題がなければ「**Copy**」（コピー）をクリックして Markdown 一式をクリップボードに送り、そのまま AI アシスタントに貼り付けます。あるいは「**Download**」（ダウンロード）をクリックしてファイルとして保存します —— どこに落ちるかは[次のセクション](#クリップはどこに保存されるか)をご覧ください。
  </Step>
</Steps>

<Note>\*\*タブを切り替えると自動的に再変換されます。\*\*この挙動が不要なら **Settings → Auto-refresh**（設定 → 自動更新）をオフにしてください。以降は手動で「**Re-convert**」（再変換）をクリックする必要があります。</Note>

<Warning>\*\*選択範囲だけのクリップには対応していません。\*\*拡張機能が抽出するのは常にページ全体の本文で、「選んだ部分だけをクリップする」という機能はありません。一部だけ残したい場合は、サイドパネルで「**Edit source**」に切り替えてご自身で削ってください。</Warning>

***

## クリップはどこに保存されるか

ここがいちばん混乱しやすいところです：**同じ「Download」ボタンでも、デスクトップアプリが動いているかどうかで、まったく別の 2 つの経路に分かれます。**

| 状況                             | 保存先                                    | その後                             |
| ------------------------------ | -------------------------------------- | ------------------------------- |
| **デスクトップアプリが起動している**           | `~/LinklyAI/Clips/<クリップのタイトル>/`        | 自動的にインデックスされ、以降は検索や AI から見つかります |
| **デスクトップアプリが起動していない、または保存に失敗** | `~/Downloads/Linkly/`（ブラウザのダウンロードフォルダ） | ただの普通のファイルで、インデックス**されません**     |

クリップ 1 件につき**1 つのディレクトリ**が作られ、その中に `.md` ファイルとその画像が入ります。

### どちらの経路を通ったか見分ける

保存すると、サイドパネル下部に次の 4 つのうち 1 つのメッセージが出ます：

| メッセージ                                                            | 意味                                 |
| ---------------------------------------------------------------- | ---------------------------------- |
| **Saved to Linkly Space**                                        | Linkly AI スペースへの保存に成功しました          |
| **Client offline — saved to browser downloads**                  | デスクトップアプリを検出できず、フォールバックしました        |
| **Couldn't save to Linkly desktop — saved to browser downloads** | 検出はできたものの転送に失敗し、フォールバックしました        |
| **Saved locally**                                                | 設定で「Save to Linkly Space」をオフにしています |

自分から確認することもできます。**Settings → Download settings**（設定 → ダウンロード設定）を開くと、「**Save to Linkly Space**」（Linkly AI スペースに保存）の行に現在の状態が表示されます —— デスクトップアプリのバージョン番号を伴う「**Online · v◯.◯.◯**」（オンライン）なら接続済み、「**App not detected**」（アプリを検出できません）なら未接続です。その隣には「**Re-check**」（再検出）と「**Launch desktop app**」（デスクトップアプリを起動）の 2 つのボタンがあります。

<Warning>\*\*フォールバックは 1 回きりで、あとから拾い直されることはありません。\*\*ブラウザのダウンロードフォルダに落ちたクリップは順番待ちの列に並ぶわけでもなく、あとからデスクトップアプリを起動しても自動的に Linkly AI スペースへ回収されることはありません。インデックスさせたい場合は、ご自身でファイルをダウンロードフォルダから Linkly AI スペースへ移すか、ダウンロードフォルダそのものを[インデックス対象のフォルダ](/docs/ja/indexing)に追加してください。</Warning>

<Note>フォールバックしても**内容は失われません** —— Markdown も画像もそろっていて、置き場所が違うだけです。ブラウザのダウンロードフォルダ内のサブフォルダ名（既定は `Linkly`）は **Settings → Download settings → Default folder**（既定のフォルダ）で変更できます。Linkly AI スペース側の `Clips/` ディレクトリは**個別に設定できません**。これは Linkly AI スペースの場所に追従します。</Note>

保存に成功するとツールバーに「**Open save location**」（保存場所を開く）ボタンが現れ、クリックするとシステムのファイルマネージャーでそのクリップのディレクトリが開きます（古いバージョンのデスクトップアプリではこのボタンは出ません）。

<Warning>デスクトップアプリにクリップを一覧する画面は**ありません**。何をクリップしたのか見たいときは、ファイルマネージャーで `~/LinklyAI/Clips` を開いてください。もちろん、クリップの内容自体は[検索ランチャー](/docs/ja/use-launcher)や [AI チャット](/docs/ja/use-chatbot)から検索できます。</Warning>

***

## クリップファイルの中身

Markdown の先頭には YAML のフロントマターがあり、Open Knowledge Format v0.1 互換であることを宣言しています —— これは AI Agent に向けたメタデータで、このファイルが何で、どこから来たのかを一目で分かるようにするためのものです：

```yaml theme={null}
---
type: "Video Transcript"
title: "What is Linkly AI?"
resource: "https://www.youtube.com/watch?v=HnGMkWaWvVo"
timestamp: 2026-07-28T12:11:16Z
site: "YouTube"
author: "Linkly AI"
---
```

フィールドの全体像：`type`（コンテンツの種類）、`title`、`description`（要約。タイトルと重複する場合は省略）、`resource`（取得元の URL）、`tags`、`timestamp`（クリップした時刻）、`site`、`author`、`published`（元記事の公開時刻）、`lang`。値があるものだけが書き込まれ、ないフィールドはそのまま省略されます。

`type` はサイトによって決まり、よくある値は `Web Article`、`WeChat Article`、`X Thread`、`Zhihu Article`、`Video Transcript`、`AI Conversation` です。

<Tip>フロントマターが不要なら、**Settings → Export content → Include frontmatter**（設定 → 書き出す内容 → フロントマターを含める）をオフにしてください。書き出されるのは本文だけになります。</Tip>

### 画像

本文中の画像は**ローカルにダウンロード**され、Markdown 内の参照はローカルの相対パスに書き換えられます —— リモートのリンクは残さないので、オフラインでも画像を見られます。

* 画像は `.md` と**同じディレクトリに並べて**置かれます。`image/` のようなサブディレクトリは作りません
* 命名規則は `<タイトル>-visual-N.<拡張子>` です
* クリップ 1 件あたり最大 200 ファイルです
* テキストだけでよければ **Settings → Export content → Include images**（画像を含める）をオフにします。画像は一切ダウンロードされず、Markdown 内の画像参照もあわせて取り除かれます

***

## サイト別の最適化

汎用の本文抽出（ナビゲーション、広告、レコメンド枠の除去）でほとんどのサイトは足りますが、構造が特殊なサイトには個別に対応しています：

| サイト                    | 対応内容                          |
| ---------------------- | ----------------------------- |
| **ChatGPT / Claude**   | 会話ページ全体の書き出し、または返信 1 件だけの書き出し |
| **X（Twitter）**         | スレッドをまるごと取得。長文のポストは個別に処理      |
| **YouTube / Bilibili** | 字幕をタイムスタンプ付きの Markdown に書き起こし |
| **WeChat 公式アカウントの記事**  | 本文、著者、公開日時                    |
| **Zhihu（知乎）**          | 回答＋コラム記事                      |
| **Lark / 飛書ドキュメント**    | DOM ではなくドキュメントのデータ構造から読み取り    |
| **Xiaohongshu（小紅書）**   | ノート本文＋カルーセル画像（アイコン画像は除外）      |
| **Weibo（微博）**          | 投稿 1 件＋添付画像                   |
| **V2EX**               | スレッド本文                        |

コードブロックは言語を自動判別して言語ラベルを付けます。それ以外のサイトは汎用の抽出経路を通ります。

***

## そのほかの機能

### ローカル翻訳

サイドパネルのツールバーにある「**Translate**」（翻訳）で、現在の Markdown を英語・簡体字中国語・繁体字中国語・日本語・韓国語に翻訳できます。いつでも原文に戻せます。

使っているのは **Chrome 内蔵の翻訳モデル**です —— API キーの設定は不要で、内容がこのパソコンから出ることもありません。ある言語ペアを初めて使うときはモデルのダウンロードが走り、サイドパネルに進捗が表示されます。新しめのバージョンの Chrome が必要です。

### リーダーモードとして使う

サイドパネルのプレビューは、それ自体がきれいなリーダーです：自動レイアウト、4 段階の文字サイズ調整、システムに追従するダークモード、そして原文と訳文の対訳表示。保存しなくても構いません。広告のない読書用ビューアとしてだけ使うのもありです。

### AI が目次を補完する

ページによっては標準的な見出し階層がなく（たとえば全体が段落だけでできている場合）、サイドパネルの目次が空になります。そんなときは「**Generate AI outline**」（AI 目次を生成）をクリックすると、Chrome 内蔵の端末内モデルが小見出しを抽出し、ジャンプできる目次を作ります。

コピーとダウンロードでは、これらの AI 見出しも既定で一緒に書き込まれます。書き出しを原文と厳密に一致させたい場合は、**Settings → Export content → Include AI-generated article headings**（AI が生成した記事見出しを含める）をオフにしてください。こちらも新しめのバージョンの Chrome が必要で、デスクトップ版の Chrome / Edge でのみ利用できます。

### AI の返信を 1 件だけ書き出す

**ChatGPT** と **Claude** の会話ページでは、拡張機能が AI の返信ごとにダウンロードボタンを差し込みます —— ページ全体をクリップしなくても、返信 1 件をワンクリックで Markdown として保存できます。

会話ページ全体をクリップすることもでき（ツールバーのアイコンから通常どおりの流れです）、その場合 `type` は `AI Conversation` になります。

***

## デスクトップアプリとの連携

### バージョンの要件

クリップを直接 Linkly AI スペースへ保存するには、**新しめのバージョンのデスクトップアプリ**が必要です —— 古すぎるバージョンにはクリップを受け取る口がなく、拡張機能からは「起動していない」と判定され、クリップはブラウザのダウンロードフォルダに落ちます。デスクトップアプリの自動更新を有効にしておけば十分で、バージョン番号を手で突き合わせる必要はありません。

### どうやって通信しているのか

拡張機能とデスクトップアプリの間は**本機のループバック HTTP のみ**（`127.0.0.1`）でつながっており、**クラウドを一切経由しません**。デスクトップアプリ側には受け入れの検査が 2 段あります：本機からの直接接続だけを通し、かつ拡張機能の発信元がホワイトリストに載っていること —— 他のプログラムやウェブページからは接続できません。

<Note>ポートが 60606 である保証はありません。既定では 60606 を待ち受けますが、使用中の場合は順に繰り上がります。拡張機能が探すのは 60606–60615 の 10 ポートだけなので、万一そのすべてが別のプログラムに占有されていると、デスクトップアプリが動いていても「起動していない」と判定され、クリップはブラウザのダウンロードフォルダに落ちます。</Note>

### クリップしてからどのくらいで検索できるか

Linkly AI スペースに入ったクリップは自動的にインデックスされますが、**すぐに検索できるわけではありません** —— ファイル監視にはデバウンスがあり、インデックスにも順番待ちがあるため、通常は数秒から数十秒かかります。クリップした直後に検索しても見つからないことがあるので、少し待ってからもう一度お試しください。

インデックスの階層のしくみと切り分け方は[インデックスの設定](/docs/ja/indexing)をご覧ください。

***

## よくある質問

<AccordionGroup>
  <Accordion title="ログインは必要ですか？料金はかかりますか？">
    \*\*ログインは不要、料金もかかりません。\*\*抽出、翻訳、コピー、ダウンロード、Linkly AI スペースへの保存 —— すべての機能がログインに依存しません。

    サイドパネルには確かに「**Sign in with Linkly AI**」（Linkly AI でサインイン）という入口がありますが、現時点ではアカウントボタンにあなたの情報を表示するためだけのものです。ログインしてもしなくても、機能には一切影響しません。
  </Accordion>

  <Accordion title="デスクトップアプリは必須ですか？起動していないときのクリップはどうなりますか？">
    必須ではありません。本文の抽出、翻訳、コピー、ダウンロードはデスクトップアプリに依存しないので、拡張機能だけで完全に使えます。デスクトップアプリを入れていると、クリップがそのまま Linkly AI スペースに入り、パソコン上の他のファイルと一緒にインデックスされ、以降はどの AI Agent からも検索できるようになります —— 併せてのご利用を強くお勧めします。

    デスクトップアプリが起動していないとき、クリップは自動的にブラウザのダウンロードフォルダ `~/Downloads/Linkly/` にフォールバックします。**内容が失われることはなく**、サイドパネルにも「Client offline — saved to browser downloads」とはっきり表示されます。ただしこれらのファイルは、あとからデスクトップアプリを起動しても**自動的には** Linkly AI スペースへ回収されません。必要なら、ご自身で移してください。
  </Accordion>

  <Accordion title="クリップしたものが見つかりません">
    次の順に探してください：

    1. **Linkly AI スペース**：`~/LinklyAI/Clips/<クリップのタイトル>/` —— デスクトップアプリが起動しているときの既定の保存先です
    2. **ブラウザのダウンロードフォルダ**：`~/Downloads/Linkly/` —— デスクトップアプリが起動していないときのフォールバック先です

    デスクトップアプリにクリップを一覧する画面は**ありません**。ファイルマネージャーで見るしかありません。どちらの経路を通ったか分からない場合は、保存時に出たメッセージが「Saved to Linkly Space」だったか「saved to browser downloads」だったかを思い出してください。
  </Accordion>

  <Accordion title="クリップした直後に検索しても見つかりません">
    正常な動作です。クリップが Linkly AI スペースに入ってからインデックスが終わるまでには、数秒から数十秒かかります —— ファイル監視にはデバウンスがあり、インデックスの処理にも順番待ちがあるためです。少し待ってから検索してみてください。

    しばらく待っても見つからない場合は、**設定 → インデックス** でインデックスの状態が止まっていないか確認してください。切り分けの方法は[インデックスの設定](/docs/ja/indexing)をご覧ください。
  </Accordion>

  <Accordion title="Firefox には対応していますか？">対応していません。拡張機能は現在 Chrome ウェブストアにのみ公開しています。Edge、Brave などの Chromium 系ブラウザは Chrome ウェブストアからそのままインストールできますが、Firefox 版はありません。</Accordion>

  <Accordion title="ショートカットやコンテキストメニューはありますか？">
    どちらもありません。拡張機能はキーボードショートカットを一切宣言しておらず、コンテキストメニューの項目も登録しません —— サイドパネルを開く方法は、ツールバーの拡張機能アイコンをクリックすることだけです。

    唯一の例外は ChatGPT と Claude のページです。そこでは AI の返信ごとにダウンロードボタンが差し込まれます。
  </Accordion>

  <Accordion title="クリップした内容はそちらのサーバーにアップロードされますか？">
    アップロードされません。本文の抽出、翻訳、目次の生成は**すべてお使いのブラウザ内で完結します**。

    保存先も 2 つだけです：本機の Linkly AI スペースか、ブラウザのダウンロードフォルダ。デスクトップアプリとの間は本機のループバック（`127.0.0.1`）でつながっており、いかなるネットワークサービスも経由しません。
  </Accordion>

  <Accordion title="なぜ「すべてのウェブサイト上のデータの読み取り」権限が必要なのですか？">
    どのサイトからでもクリップできる必要があるため、開いているページで抽出スクリプトを実行できなければならないからです。読み取るのは**あなたが自分でクリックしたときの**現在のタブの内容だけで、バックグラウンドで閲覧内容をスキャンすることはありません。
  </Accordion>
</AccordionGroup>

***

## 関連ドキュメント

* [インデックスの設定](/docs/ja/indexing) —— クリップが Linkly AI スペースに入ったあと、どのようにインデックスされるのか
* [検索ランチャーの使い方](/docs/ja/use-launcher) —— クリップした内容を見つける最速の方法
* [ライブラリの使い方](/docs/ja/use-libraries) —— クリップを特定のライブラリに入れて、AI に範囲を絞って検索させる
* [クイックスタート](/docs/ja/quickstart) —— デスクトップアプリのインストールと初期設定
* [Linkly AI スペース](/docs/ja/linkly-space) —— クリップが落ちるフォルダ。場所は変更できます
* [AI チャットを使う](/docs/ja/use-chatbot) —— クリップしたウェブページを AI に直接読ませる