LionScraper(라이언스크레이퍼) MCP + CLI 서비스

이것은 무엇인가요?

**LionScraper(라이언스크레이퍼)**는 웹 페이지에서 목록, 기사, 링크, 이미지 등을 수집할 수 있는 브라우저 확장 프로그램입니다. 이 저장소에서 제공하는 것은 MCP 서비스입니다. 이를 사용하는 AI 소프트웨어(예: Cursor)에 연결하면, 메뉴를 일일이 클릭할 필요 없이 대화 중에 AI에게 수집 작업을 요청할 수 있습니다.

이 서비스를 '작은 다리'라고 생각하세요. 한쪽에는 AI 소프트웨어가 있고, 다른 쪽에는 브라우저 확장 프로그램이 있으며, 이 서비스는 그 사이에서 메시지를 전달하는 역할을 합니다. 실제 수집 로직은 확장 프로그램에서 수행되며, 이 서비스는 연결과 전달만 담당합니다.

사용 전 준비 사항

브라우저: Chrome 또는 Edge (확장 프로그램이 실제로 지원하는 브라우저 기준).
LionScraper 확장 프로그램: 브라우저 확장 프로그램 스토어에서 설치 및 활성화 (스토어에 표시된 이름 기준).
Node.js: 컴퓨터에 18 버전 이상이 설치되어 있어야 합니다. 아직 설치하지 않았다면 Node.js 공식 홈페이지에서 설치 파일을 다운로드하여 안내에 따라 설치하세요.
MCP 지원 AI 소프트웨어: Cursor, Trae 등 (각 소프트웨어의 MCP 지원 여부 확인).

MCP 서비스 설치 (npm 패키지)

본 서비스는 npm에 **lionscraper**라는 이름으로 배포되어 있습니다. 해당 링크를 클릭하여 설명과 버전 정보를 확인할 수 있습니다.

컴퓨터에서 터미널(Windows의 경우 '명령 프롬프트' 또는 PowerShell)을 열고 다음을 실행하세요:

npm install -g lionscraper

설치가 완료되면 시스템에 두 가지 공용 명령어가 추가됩니다: lionscraper-mcp(AI 소프트웨어 MCP 연결용)와 lionscraper(터미널 CLI). 두 명령어 모두 동일한 로컬 데몬과 확장 프로그램 브리지에 의존하며, PORT(기본값 13808)는 확장 프로그램의 브리지 포트와 일치해야 합니다.

전역 설치를 원하지 않는 경우, AI 소프트웨어의 MCP 설정에서 npx를 사용하여 임시로 가져와 실행할 수도 있습니다(Node.js가 설치되어 있어야 함). 예시: 시작 명령어를 npx로 설정하고, 인수를 -y, -p, lionscraper, lionscraper-mcp 순으로 입력(구체적인 JSON 형식은 사용하는 소프트웨어의 MCP 설정 설명 참조).

CLI (터미널)

전역 설치가 완료된 상태에서 터미널을 통해 **lionscraper**를 사용하여 스크립트 기반 수집을 수행하거나 MCP와 병행하여 사용할 수 있습니다(동일한 lionscraper daemon 및 PORT 공유):

lionscraper daemon: 상주 실행되며, 동일한 포트에서 HTTP(CLI / 씬 MCP 호출) 및 WebSocket(확장 프로그램 연결)을 제공합니다.
lionscraper stop: 현재 설정된 포트에서 실행 중인 데몬을 중지합니다.
lionscraper ping: 확장 프로그램이 브리지에 등록되었는지 확인합니다(MCP 대화 거치지 않음).
lionscraper scrape: 수집을 시작합니다. **--method**를 사용하여 목록/본문/이메일/전화번호/링크/이미지 등 모드를 선택할 수 있으며, 이는 MCP 도구 기능과 대응됩니다.

예시:

lionscraper daemon
lionscraper ping
lionscraper scrape -u https://www.example.com

더 자세한 매개변수 설명, 다중 URL, 페이징 및 필터링 등은 본 저장소의 packages/node/README_cn.md를 참조하세요. 영어 설명은 npm 페이지와 동일하며, npm의 lionscraper 패키지에서 확인할 수 있습니다.

AI 소프트웨어에 MCP 추가하기

다음 예시는 전역 설치를 가정합니다(소프트웨어 인터페이스에 따라 다를 수 있음). MCP에서 env의 값은 모두 문자열입니다.

간단한 설정(env를 작성하지 않을 경우 PORT는 기본값 13808이며, 확장 프로그램 브리지 포트와 일치해야 함):

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp"
    }
  }
}

상세 설정(필요에 따라 키를 삭제하거나 수정 가능; 빈 문자열과 키 생략은 유사한 의미를 가짐):

{
  "mcpServers": {
    "lionscraper": {
      "command": "lionscraper-mcp",
      "env": {
        "PORT": "13808",
        "TIMEOUT": "120000",
        "LANG": "zh-CN",
        "TOKEN": "",
        "DAEMON": ""
      }
    }
  }
}

PORT: HTTP + WebSocket 수신 포트, 기본값 13808, 확장 프로그램의 브리지 포트와 일치해야 함.
TIMEOUT: 포트 점유 시 이전 인스턴스가 종료될 때까지 대기하는 시간(밀리초), 기본값 120000; **0**은 즉시 강제 점유를 의미함.
LANG: 도구 설명 및 stderr 로그 언어(예: zh-CN, en-US).
TOKEN: 데몬과 일치하는 Bearer 토큰; 비워두면 인증을 사용하지 않음.
DAEMON: **0**으로 설정 시 씬 MCP가 자동으로 데몬을 실행하는 것을 방지; 비워두거나 다른 값은 생략과 동일.

설정을 저장한 후, 소프트웨어의 요구 사항에 따라 MCP를 재시작하거나 소프트웨어를 재시작하여 새 설정을 적용하세요.

브라우저 확장 프로그램에서 포트 맞추기

LionScraper의 설정 또는 옵션 페이지를 엽니다.
브리지 포트(또는 유사한 이름)를 찾아 이전 단계의 MCP 설정에 있는 **PORT**와 동일한 숫자로 설정합니다(예: 13808).
포트를 변경했거나 연결에 문제가 있는 경우, 확장 프로그램에서 **'재연결(Reconnect)'**을 사용하세요. 그래도 안 되면 확장 프로그램 다시 로드 또는 브라우저 재시작을 시도하세요.

일상적인 사용 방법

확장 프로그램이 활성화된 상태를 유지하고, 수집이 필요한 페이지가 브라우저에 열려 있도록 하세요(또는 확장 프로그램의 요구 사항에 따름).
AI 대화창에서 자연어로 요구 사항을 설명하세요. 예:
- "LionScraper 확장 프로그램이 연결되어 있는지 확인해 줘."
- "이 웹 페이지의 목록 데이터 / 기사 본문 / 이메일 / 전화번호 / 링크 / 이미지를 수집해 줘."
AI가 MCP를 통해 확장 프로그램을 호출합니다. 연결되지 않았거나 시간 초과 오류가 발생하면, AI에게 연결 상태를 다시 확인하도록 요청하고 포트 일치 여부 및 확장 프로그램 활성화 상태를 확인하세요.

자주 묻는 질문 (FAQ)

질문: 확장 프로그램이 연결되지 않았거나 수집에 실패했다는 메시지가 뜹니다.

확장 프로그램이 열려 있고 비활성화되지 않았나요?
AI에 설정된 포트와 확장 프로그램의 브리지 포트가 완벽하게 일치하나요?
동일한 컴퓨터에서 이 서비스와 확장 프로그램의 브리지는 일반적으로 한 세트만 필요합니다. 여러 MCP 설정을 동시에 열거나 중복 설치하면 충돌이 발생할 수 있습니다.

질문: AI에서 이미 많은 '도구'가 보이는데, 그럼 연결이 확실히 된 건가요?

그렇지 않습니다. 도구가 보인다는 것은 AI와 본 서비스 사이의 연결이 성공했다는 의미일 뿐입니다. 확장 프로그램도 동일한 포트에 연결되어 등록을 완료해야 합니다.

MCP Registry 및 타사 디렉토리 등록

본 저장소는 공식 MCP Registry에 두 개의 패키지로 등록되어 있습니다(메타데이터 파일명은 모두 server.json):

디렉토리	Registry 이름	설명
`packages/node/server.json`	`io.github.dowant/lionscraper-node`	npm 패키지 `lionscraper`와 대응, `package.json`에 `mcpName` 검증 필드 포함
`packages/python/server.json`	`io.github.dowant/lionscraper-python`	PyPI 패키지 `lionscraper`와 대응, 영어 `README.md`에 PyPI 설명에 필요한 `mcp-name` 주석 포함

Registry 등록 단계 요약(공식 CLI가 로컬에 설치되어 있어야 함, Quickstart 참조):

npm / PyPI를 각 server.json의 **version**과 일치하는 버전으로 배포합니다(현재 예시는 1.0.3).
저장소 루트에서 **packages/node**로 이동하여 mcp-publisher login github를 실행(1회만 수행)한 후, mcp-publisher publish를 실행합니다.
**packages/python**으로 이동하여 동일하게 mcp-publisher publish를 실행합니다(로그인 정보 재사용 가능).

타사 디렉토리는 통일된 입구가 없으며, 일반적인 방법은 Glama에서 Add Server를 통해 사이트 절차에 따라 제출하는 것입니다. Smithery는 주로 공용 HTTPS + Streamable HTTP를 대상으로 하며, 본 저장소의 stdio + npm/pip 설치 중심 형태와는 다르므로 별도의 호스팅 방안을 마련한 후 고려해야 합니다.

라이선스

MIT (npm 패키지 lionscraper와 동일).

LionScraper