NeoDownloader
ヘルプトピック

設定

すべてのヘルプトピック

AI アプリとの連携

NeoDownloader があるサイトからダウンロードできない、または目的のものをダウンロードできないときは、AI アプリに教えてもらえます。アプリはサイトを調べ、サイトがファイルをどこに置いているかを短くまとめたレシピを書きます。NeoDownloader に AI は組み込まれていませんが、お使いのアプリを接続でき、プログラムのウィンドウではそれをエージェントと呼びます。接続には、AI アプリがほかのプログラムと連携するための一般的な方法である MCP を使います。このページでは、この機能の用途、アプリの接続、「AI エージェント」画面、「AI で修正」を扱います。

何のためのものか

Crawler は、サイトのページをたどって、見つけたファイルを取得するプラグインです。Crawler はレシピに従って動きます。レシピは、サイトがファイルをどこに置いているか、それをどうページ送りしてたどるかを伝えます。

名前を知っているサイトには、そのサイト専用のレシピがあります。それ以外のサイトには、ページの種類ごとにある 4 つの汎用レシピのどれかを使います。ギャラリーやフォーラムのスレッドなどです。汎用レシピは個別のサイトのことを知らないため、いつもうまくいくとは限りません。

何も得られないか、求めるものが得られないときは、AI アプリがそのサイト用のレシピを書けます。サイトが変わったあとでレシピがファイルを見つけられなくなったときも同じで、アプリが修正します。

レシピは一度作れば済みます。以降はどのプロジェクトでもそのレシピがサイトを扱い、実行にアプリは必要ありません。アプリ自身は何もダウンロードしません。テスト実行はファイルを一覧にするだけで、ダウンロードは開始したプロジェクトが行います。アプリは、お使いのサブスクリプションか、アプリに無料のモデルがあればそのモデルで動作します。

まず通常のプロジェクトを試してください。Crawler のページの種類で対応できることが多く、アプリなら数分かかるところが数秒で済みます。レシピを作るより当社の対応を待つほうがよければ、このサイトのレシピをリクエストするを使ってください。

レシピを読むのは Crawler だけです。Video Downloader、Gallery Downloader、直接リンクは読みません。

アプリが見られるものとできること

アプリの作業はすべて見える形で行われ、各ステップが後述のジャーナルに 1 行ずつ記録されます。アプリが何を受け取るか、何ができないか、回答がどこへ渡る可能性があるかは、接続する AI アプリにあります。アプリを接続する前に読んでください。NeoDownloader のブラウザーでサイトにログインしている場合は、特に読んでおいてください。

OpenCode の無料モデルを使う場合は、使う前にモデルを確認してください。OpenCode の一覧に、各無料モデルがデータをどう扱うかが書かれています。この記事の執筆時点では、DeepSeek V4.1 Flash Free と GLM-5.3-Flash Free はデータを保存せず学習にも使いませんが、ほかのモデルは 30 日間保存したり、モデルの改善に使ったりすることがあります。

アプリを接続する

AI アプリをお持ちでない場合は、こちらから始めてください。

これは一度だけ、NeoDownloader を実行しているコンピューターで行います。

  1. 左のバーの「AI エージェント」をクリックします。
  2. 画面の最初の行の下にある「接続方法」をクリックします。
  3. 「AI でレシピを作る」ウィンドウの「AI アプリを接続」の下で、一覧から使っているアプリを選びます。
  4. Claude Desktop、ChatGPT / Codex、OpenCode では「Claude Desktop に追加」、「ChatGPT / Codex に追加」または「OpenCode に追加」をクリックします。NeoDownloader がアプリの設定ファイルに項目を書き込みます。その他のアプリでは、ウィンドウの指示に従います。「コピー」でテキストをコピーできます。テキストにはこのコンピューターのパスがすでに入っています。
  5. AI アプリを再起動します。NeoDownloader 自体の再起動は必要ありません。

ボタンはファイルの他の部分を変更せず、元のファイルを名前の末尾に .before-neodownloader を付けて隣に残します。ファイルを読み取れない場合は変更せず、「手動で追加」の下にテキストを開きます。このリンクは単独でも使えます。

アプリが動作しているあいだ、NeoDownloader は起動している必要があります。閉じている場合はアプリにそのことが伝わり、アプリから起動を頼まれるはずです。

テキストの追加先

ウィンドウには貼り付けられる状態のテキストが表示されます。以下は、アプリごとの追加先とテキストの形です。この例の PROGRAM はコンピューター上の NeoDownloader のパス、FOLDER はそのデータフォルダーを表します。テキストはウィンドウからコピーしてください。

設定ファイルにすでに別のサーバーが書かれている場合は、neodownloader の項目を同じ一覧の中にそれらと並べて置きます。このテキストにパスワードやキーは含まれません。接続に必要なものは NeoDownloader のデータフォルダーから読み取られます。

Claude Desktop

お使いのシステムのファイルに次の内容を追加します。

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Claude Code

ターミナルで次を実行します。

claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER
ChatGPT / Codex

次の内容を ~/.codex/config.toml に追加します。Windows では %USERPROFILE%\.codex\config.toml です。

[mcp_servers.neodownloader]
command = "PROGRAM"
args = ["--mcp", "--install-dir", "FOLDER"]

ChatGPT のデスクトップアプリと Codex はこのファイルを読み込みます。ブラウザーの ChatGPT は接続できないため、デスクトップアプリをインストールしてください。

Cursor

次の内容を ~/.cursor/mcp.json に追加します。Windows では %USERPROFILE%\.cursor\mcp.json です。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
VS Code

Command Palette > MCP: Open User Configuration を開き、次の内容を追加します。

{
  "servers": {
    "neodownloader": {
      "type": "stdio",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
GitHub Copilot CLI

次の内容を ~/.copilot/mcp-config.json に追加します。Windows では %USERPROFILE%\.copilot\mcp-config.json です。

{
  "mcpServers": {
    "neodownloader": {
      "type": "local",
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"],
      "tools": ["*"]
    }
  }
}
OpenCode

次の内容を ~/.config/opencode/opencode.json に追加します。Windows では %USERPROFILE%\.config\opencode\opencode.json です。

{
  "mcp": {
    "neodownloader": {
      "type": "local",
      "command": ["PROGRAM", "--mcp", "--install-dir", "FOLDER"],
      "enabled": true
    }
  }
}
Antigravity

次の内容を ~/.gemini/config/mcp_config.json に追加します。Windows では %USERPROFILE%\.gemini\config\mcp_config.json です。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Windsurf

Cascade > MCP > Open MCP config file を開き、次の内容を追加します。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
JetBrains AI Assistant

Settings | Tools | AI Assistant | Model Context Protocol (MCP) | Add を開き、次の内容を追加します。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Zed

Command Palette > zed: open settings file を開き、次の内容を追加します。

{
  "context_servers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Cline

MCP Servers > Configure > Configure MCP Servers を開き、次の内容を追加します。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Roo Code

MCP > Edit Global MCP を開き、次の内容を追加します。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
Kiro

次の内容を ~/.kiro/settings/mcp.json に追加します。Windows では %USERPROFILE%\.kiro\settings\mcp.json です。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
LM Studio

Program > Install > Edit mcp.json を開き、次の内容を追加します。

{
  "mcpServers": {
    "neodownloader": {
      "command": "PROGRAM",
      "args": ["--mcp", "--install-dir", "FOLDER"]
    }
  }
}
その他

MCP で接続でき、このコンピューターのプログラムを起動できるその他のアプリには、ウィンドウがコマンドと引数を示します。

command: PROGRAM
args: --mcp --install-dir FOLDER

多くのアプリは Cursor と同じテキストを受け付けます。インターネット上のサーバーにしか届かないアプリは接続できません。この接続はお使いのコンピューターの中にとどまるためです。

レシピを頼む

アプリのメッセージ欄に書きます。たとえば「example.com 用の NeoDownloader レシピを作ってください。」のように書きます。自分の言葉でも、NeoDownloader が用意する文でもかまいません。

同じウィンドウが3つの場所から開きます。

  • アプリが接続したあとの、「レシピ」タブの上部にある「AI でレシピを作る」。そこの文にはサイトの空欄があるので、その箇所にアドレスを入れます。
  • 「新しいプロジェクト」ウィザードの「ファイルはどこから来ますか？」の下にある「このサイトのレシピを AI で作る」。
  • プロジェクトの「AI で修正」。後述を参照してください。

アプリが接続すると、上の手順は「最後に NeoDownloader を呼び出したのは Claude Desktop です (…)。」のような 1 行に折りたたまれ、「別のアプリを接続する方法」で再び開きます。「エージェントに伝える」の下に、NeoDownloader のウィンドウの言語で書かれた文があります。「コピー」でコピーし、アプリに貼り付けます。

ウィザードから開いたウィンドウの最後には「エージェントがレシピを保存すると、ウィザードが自動で取り込みます。」と表示されます。ウィザードは開いたままにしてください。レシピが保存されると、ウィザードはプラグインにもう一度問い合わせ、「エージェントがレシピを保存したので、ウィザードがアドレスをもう一度確認しました。」と表示します。

レシピを保存したとアプリが伝えたら、サイトのアドレスで通常のプロジェクトを作成します。Crawler がそのレシピを使うようになり、プロジェクトがファイルをダウンロードします。レシピは「レシピ」タブにも表示されます。

「AI エージェント」画面

「AI エージェント」は、どの画面でも左のバーにあり、ウィンドウでは接続したアプリをエージェントと呼びます。項目の点は、新しいものがあることを示します。NeoDownloader が自動でこの画面に移動することはありません。

左の列の上部にアプリの状態が表示され、その下に「Claude Desktop 1.2 経由」のようにアプリの名前が表示されます。

行の表示 意味
AI エージェントはまだ接続されていません この NeoDownloader を呼び出したアプリは、まだありません。
AI エージェントが作業中 アプリが直近 1 分以内に呼び出しました。
AI エージェントは待機中 アプリは接続済みで、今は動きがありません。
AI エージェントは停止中 「MCP を許可」がオフです。
エージェントからのお願い アプリがあなたの操作を待っています。

ジャーナル

その行の下がジャーナルです。アプリのステップごとに 1 行ずつ、NeoDownloader のウィンドウの言語で記録され、最新のものがいちばん下に来ます。時刻は、各分の最初のステップに表示されます。アプリの名前が変わると、次のアプリの名前を示す見出しが入ります。

  • 失敗したステップの行には印が付きます。印にポインターを合わせると、理由が表示されます。「拒否」、「停止済み」、「時間切れ」、「失敗」のいずれかです。
  • 「下書きのサイトの外」は、レシピの対象サイトから外に出たステップを示します。
  • ページを開いたステップをクリックすると、そのページをもう一度表示できます。
  • 上にスクロールすると、ジャーナルはその位置にとどまり、「新着: 3」で最新のステップへ移動します。
  • 「クリア」は確認なしで、すぐにジャーナルを空にします。レシピと下書きは残ります。

アプリがサイトでのログインや確認のために、あなたの操作を必要とすることがあります。その依頼はジャーナルの「エージェントからのお願い」の下に、「ページを表示」とともに表示されます。ページで求められたことを済ませてから、アプリに伝えてください。

ページとレシピ

ジャーナルの右には2つのタブがあります。「ページ」はアプリがページを開いているあいだ表示され、そのページを NeoDownloader のブラウザーで表示します。「レシピ」には、自分のレシピが一覧表示されます。アプリの新しいページがパネルに表示されるのは、「レシピ」を選んでいないときだけです。自分で選んだタブはそのままです。タブの点は、そこに新しいものが届いたことを示します。

ウィンドウの幅が狭いときは 1 列になり、「ジャーナル」、「ページ」、「レシピ」がタブになります。

レシピ

「レシピ」タブには、自分のレシピが一覧表示されます。AI アプリが保存したものと、以前のバージョンのレシピエディターで保存したものです。カタログのレシピはここには表示されません。自分のレシピは、どのプロジェクトでもカタログのレシピより優先してそのサイトを扱います。

レシピのカードには、名前、対象サイト、保存日時が表示され、次の印が付くことがあります。

  • AI が作成 - AI アプリが保存しました。
  • コード付き - レシピの横に独自のコードがあります。
  • 読み込めません - 修正されるまで NeoDownloader はこのレシピを飛ばします。カードに問題の内容が表示されます。

「カタログのレシピの代わりに使用: …」は、そのレシピが何の代わりになっているかを示します。

「削除」は先に確認し、そのあとそのサイトを何が扱うかを表示します。カタログのレシピか、Crawler の一般的なページの種類のどちらかです。「コピーはレシピと同じ場所の .prev フォルダーに残ります。」と表示されます。レシピを削除できるのはあなただけで、アプリにはできません。

MCP を許可

画面の最初の行の下にある「MCP を許可」は、アプリへの許可です。オフにすると、NeoDownloader はアプリが何を求めても MCP での AI アプリへの応答をやめ、アプリが開始していたものは、開いているページも含めて停止します。画面には「MCP はオフです: MCP を再び許可するまで、AI アプリの呼び出しはすべて拒否されます。」と表示されます。

オンにするまで、再起動後もオフのままです。アプリと NeoDownloader の連携を完全にやめるには、アプリ自身の設定からも NeoDownloader を削除してください。

AI で修正

開いているプロジェクトの「プロパティ」タブの、プロジェクトのプロパティと「プロジェクトを削除」のあいだに、「AI で修正」のカードがあります。これは「AI でレシピを作る」ウィンドウを開き、まだアプリが接続していない場合は接続の手順も表示します。文が何を頼むかは、プロジェクトのプラグインによって異なります。

Crawler のプロジェクトでは、文にサイト、アドレス、最後の実行で得られたファイルの数が入り、レシピが動かなくなった原因を調べて直すようアプリに頼みます。

ほかのプラグインのプロジェクトには直すレシピがないので、そのアドレス用の新しいレシピを作るようアプリに頼みます。カードにもそのことが表示されます: 「レシピは Crawler 用で、このプロジェクトは別のプラグインでダウンロードしています。AI エージェントにこのサイトのレシピを作らせ、そのあと Crawler でこのアドレスの新しいプロジェクトを作ってください。」元のプロジェクトはそのまま残ります。

プラグインがなくなったプロジェクトにも、タブ上部の警告の中に「AI で修正」があり、こちらも新しいレシピを頼みます。