AI 앱과 함께 작업하기

NeoDownloader가 어떤 사이트에서 다운로드하지 못하거나 원하는 것을 다운로드하지 못하면 AI 앱이 가르칠 수 있습니다. 앱은 사이트를 살펴보고, 사이트가 파일을 어디에 두는지 짧게 설명한 레시피를 작성합니다. NeoDownloader에는 AI가 내장되어 있지 않지만, 사용하는 앱을 연결할 수 있으며 프로그램 창에서는 이를 에이전트라고 부릅니다. 연결에는 AI 앱이 다른 프로그램과 함께 작업하는 일반적인 방식인 MCP를 사용합니다. 이 페이지에서는 이 기능의 쓰임새, 앱 연결, ‘AI 에이전트’ 화면, ‘AI로 수정’을 다룹니다.

쓰임새

Crawler는 사이트의 페이지를 돌아다니며 찾은 파일을 가져오는 플러그인입니다. Crawler는 레시피에 따라 작동합니다. 레시피는 사이트가 파일을 어디에 두는지, 그 페이지를 어떻게 넘기는지를 알려 줍니다.

이름을 아는 사이트에는 그 사이트 전용 레시피가 있습니다. 그 밖의 사이트에는 페이지 종류마다 하나씩 있는 네 가지 일반 레시피 중 하나를 씁니다. 갤러리나 포럼 글타래 같은 것입니다. 일반 레시피는 개별 사이트를 전혀 모르기 때문에 항상 통하지는 않습니다.

아무것도 나오지 않거나 원하는 것이 나오지 않으면 AI 앱이 그 사이트용 레시피를 작성할 수 있습니다. 사이트가 바뀐 뒤 레시피가 파일을 찾지 못하게 된 경우도 마찬가지로, 앱이 고쳐 줍니다.

레시피는 한 번만 만들면 됩니다. 그 뒤로는 레시피가 모든 프로젝트에서 그 사이트를 처리하며, 실행에는 앱이 필요 없습니다. 앱은 직접 아무것도 내려받지 않습니다. 앱의 시험 실행은 파일 목록만 만들고, 내려받기는 직접 시작한 프로젝트가 합니다. 앱은 구독으로 작동하거나, 앱에 무료 모델이 있으면 그 모델로 작동합니다.

먼저 일반 프로젝트를 시도해 보세요. Crawler의 페이지 종류로 해결되는 경우가 많고, 앱이 몇 분 걸리는 일을 몇 초 만에 끝냅니다. 레시피를 만드는 대신 저희를 기다리려면 이 사이트의 레시피 요청하기를 쓰세요.

레시피를 읽는 것은 Crawler뿐입니다. Video Downloader, Gallery Downloader, 직접 링크는 읽지 않습니다.

앱이 볼 수 있는 것과 할 수 있는 일

앱의 작업은 모두 드러납니다. 모든 단계가 아래에서 설명하는 기록에 항목으로 남습니다. 앱이 받는 것, 할 수 없는 일, 앱의 답변이 갈 수 있는 곳은 연결한 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가 실행되어 있어야 합니다. NeoDownloader가 닫혀 있으면 앱에 그 사실이 전달되며, 앱이 시작해 달라고 요청할 것입니다.

텍스트를 넣을 곳

창에는 바로 붙여 넣을 수 있는 텍스트가 표시됩니다. 아래에서 앱별로 텍스트를 넣을 곳과 형식을 볼 수 있습니다. 이 예시에서 PROGRAM은 컴퓨터에 있는 NeoDownloader의 경로를, FOLDER는 그 데이터 폴더를 나타내므로 텍스트는 창에서 복사하세요.

설정 파일에 다른 서버가 이미 있으면 neodownloader 항목을 같은 목록의 그 옆에 넣으세요. 이 텍스트에는 비밀번호나 키가 들어 있지 않습니다. 연결에 필요한 것은 NeoDownloader의 데이터 폴더에서 읽습니다.

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

claude mcp add --scope user neodownloader -- PROGRAM --mcp --install-dir FOLDER

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

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

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

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

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

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

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

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

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

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

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

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

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

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

레시피 요청하기

앱의 메시지 입력란에 쓰세요. 예를 들면 ‘example.com용 NeoDownloader 레시피를 만들어 줘.’처럼 쓰면 됩니다. 직접 쓴 말이나 NeoDownloader가 준비한 문장도 괜찮습니다.

같은 창이 세 곳에서 열립니다.

• 앱이 연결된 뒤 ‘레시피’ 탭 맨 위에 나오는 ‘AI로 레시피 만들기’. 여기서는 문장에 사이트 자리가 비어 있으니, 그 자리에 주소를 넣으세요.
• ‘새 프로젝트’ 마법사의 ‘파일은 어디에서 오나요?’ 아래에 있는 ‘AI로 이 사이트의 레시피 만들기’
• 프로젝트의 ‘AI로 수정’. 아래를 참고하세요.

앱이 연결되면 위의 단계는 ‘마지막으로 NeoDownloader를 호출한 앱: Claude Desktop (…).’ 같은 한 줄로 접히고, ‘다른 앱을 연결하는 방법’을 누르면 다시 펼쳐집니다. ‘에이전트에게 말하기’ 아래에 NeoDownloader 창의 언어로 쓰인 문장이 있습니다. ‘복사’로 복사해서 앱에 붙여 넣으세요.

마법사에서 연 창은 ‘에이전트가 레시피를 저장하면 마법사가 알아서 반영합니다.’로 끝납니다. 마법사를 열어 두세요. 레시피가 저장되면 마법사가 플러그인에 다시 묻고 ‘에이전트가 레시피를 저장해서 마법사가 주소를 다시 확인했습니다.’라고 알립니다.

앱이 레시피를 저장했다고 알려 주면 사이트 주소로 일반 프로젝트를 만드세요. 이제 Crawler가 그 레시피를 쓰고, 프로젝트가 파일을 다운로드합니다. 레시피는 ‘레시피’ 탭에도 나타납니다.

AI 에이전트 화면

‘AI 에이전트’는 모든 화면에서 왼쪽 사이드바에 있으며, 창에서는 연결된 앱을 에이전트라고 부릅니다. 이 항목의 점은 새로운 내용이 있다는 뜻입니다. NeoDownloader가 저절로 이 화면으로 데려가는 일은 없습니다.

왼쪽 열 맨 위에는 앱이 하고 있는 일이 나오고, 그 아래에 ‘Claude Desktop 1.2 통해’처럼 앱 이름이 나옵니다.

기록

그 줄 아래에 기록이 있습니다. 앱의 단계마다 항목이 하나씩, 가장 최근 것이 맨 아래에 NeoDownloader 창의 언어로 나옵니다. 시간은 매분 첫 단계에 표시됩니다. 앱 이름이 바뀌면 다음 앱의 이름을 알리는 제목이 나옵니다.

• 실패한 단계의 항목에는 표시가 붙습니다. 표시를 가리키면 ‘거부됨’, ‘중지됨’, ‘너무 오래 걸림’, ‘실패’ 중 하나로 이유가 나옵니다.
• ‘초안 사이트 밖’은 레시피 대상 사이트를 벗어난 단계를 표시합니다.
• 페이지를 연 단계를 클릭하면 그 페이지를 다시 볼 수 있습니다.
• 위로 스크롤하면 기록은 그 자리에 머물고, ‘새 항목: 3’을 누르면 최신 단계로 갑니다.
• ‘지우기’는 묻지 않고 바로 기록을 비웁니다. 레시피와 초안은 남습니다.

앱이 사이트의 로그인이나 확인 절차를 직접 해 달라고 할 수 있습니다. 그 요청은 기록의 ‘에이전트가 요청합니다’ 아래에 ‘페이지 보기’와 함께 나옵니다. 페이지에서 요청한 일을 마친 뒤 앱에 알려 주세요.

페이지와 레시피

기록 오른쪽에 탭 두 개가 있습니다. ‘페이지’는 앱이 페이지를 열어 둔 동안 나타나며, 그 페이지를 NeoDownloader 브라우저로 보여 줍니다. ‘레시피’에는 레시피 목록이 나옵니다. 앱이 새로 연 페이지는 ‘레시피’를 고르지 않았을 때만 패널을 차지합니다. 직접 고른 탭은 그대로 유지됩니다. 탭의 점은 그 탭에 새로운 내용이 왔다는 뜻입니다.

창이 좁으면 열이 하나가 되고 ‘기록’, ‘페이지’, ‘레시피’가 탭으로 나옵니다.

레시피

‘레시피’ 탭에는 직접 만든 레시피, 즉 AI 앱이 저장한 레시피와 이전 버전의 레시피 편집기로 저장한 레시피가 나옵니다. 카탈로그의 레시피는 여기에 나오지 않습니다. 직접 만든 레시피는 카탈로그의 레시피보다 우선하여 모든 프로젝트에서 그 사이트를 처리합니다.

레시피 카드에는 이름, 사이트, 저장한 시점이 나오고, 다음 표시가 붙을 수 있습니다.

• AI가 만듦 - AI 앱이 저장했습니다.
• 코드 포함 - 레시피 옆에 자체 코드가 있습니다.
• 읽을 수 없음 - NeoDownloader는 고쳐질 때까지 이 레시피를 건너뜁니다. 무엇이 잘못되었는지는 카드에 나옵니다.

‘카탈로그 레시피 대신 사용: …’ 표시는 그 레시피가 무엇을 대신하는지 알려 줍니다.

‘삭제’는 먼저 확인을 구하며, 그 뒤에 이 사이트들을 무엇이 처리할지 알려 줍니다. 카탈로그의 레시피 또는 Crawler의 일반 페이지 종류입니다. 복사본은 레시피 옆의 .prev 폴더에 남습니다. 레시피를 삭제할 수 있는 것은 본인뿐이며, 앱은 삭제할 수 없습니다.

MCP 허용

화면 첫 줄 아래의 ‘MCP 허용’은 앱에 주는 권한입니다. 이를 끄면 NeoDownloader는 앱이 무엇을 요청하든 MCP로 AI 앱에 응답하지 않으며, 앱이 시작한 일은 열어 둔 페이지를 포함해 모두 멈춥니다. 화면에는 ‘MCP 꺼짐: MCP를 다시 허용할 때까지 AI 앱의 모든 호출이 거부됩니다.’라고 나옵니다.

다시 시작해도 켤 때까지 꺼진 상태로 유지됩니다. 앱이 NeoDownloader와 아예 작업하지 못하게 하려면 앱 자체 설정에서도 NeoDownloader를 제거하세요.

AI로 수정

열린 프로젝트의 ‘속성’ 탭에서 프로젝트 속성과 ‘프로젝트 삭제’ 사이에 ‘AI로 수정’ 카드가 있습니다. 이 카드는 ‘AI로 레시피 만들기’ 창을 열며, 아직 연결된 앱이 없으면 연결 단계도 함께 보여 줍니다. 문장이 무엇을 요청하는지는 프로젝트의 플러그인에 따라 다릅니다.

Crawler 프로젝트에서는 문장에 사이트, 주소, 마지막 실행이 가져온 파일 수가 들어가며, 레시피가 왜 작동을 멈췄는지 찾아내 고쳐 달라고 앱에 요청합니다.

다른 플러그인의 프로젝트에는 고칠 레시피가 없으므로, 그 주소에 맞는 새 레시피를 만들어 달라고 앱에 요청합니다. 카드에도 그렇게 나옵니다. ‘레시피는 Crawler용이고, 이 프로젝트는 다른 플러그인으로 다운로드합니다. AI 에이전트에게 이 사이트의 레시피를 만들게 한 다음, Crawler로 이 주소의 새 프로젝트를 만드세요.’ 출발점이 된 프로젝트는 그대로 남습니다.

플러그인이 사라진 프로젝트에도 탭 맨 위의 경고에 ‘AI로 수정’이 있으며, 이 경우에도 새 레시피를 요청합니다.