Communitygithub.com

Amadeus1P048596/mteam-pt-codex-skill

M-Team PT 사이트 검색, 즐겨찾기, 트래커 상태 조회, 일일 Keepalive 등을 위한 포터블 Codex 스킬

mteam-pt-codex-skill란 무엇인가요?

이 스킬은 M-Team 비공개 트래커(PT)를 위한 포터블 Codex 에이전트 스킬입니다. 사용자는 CLI 스크립트(`scripts/mteam_pt.py`)를 통해 M-Team API에 접근하여 토렌트 검색, 즐겨찾기 추가/제거, 프로필 조회, 즐겨찾기 목록 확인, 세부 정보 확인 및 API 상태 진단 등을 수행할 수 있습니다. API 키는 `MTEAM_API_KEY` 환경 변수로만 전달되며, 명령줄에 직접 입력하지 않도록 설계되어 보안을 유지합니다. 검색 결과는 번호가 매겨져 표시되며, `search_id`를 통해 이후 작업(즐겨찾기, 상세 보기)이 동일한 결과 목록에 바인딩됩니다. 정렬 기준은 시더 수, 리처 수, 완료 수, 크기, 생성일, 제목, 진행률 등 다양하게 지원하며, '무료' 필터 및 카테고리(movie/tvshow/normal)를 적용할 수 있습니다. 즐겨찾기 작업은 명시적인 '숫자 N번째 결과를 즐겨찾기' 요청이 있을 때만 실행되며, 다운로드는 별도 RSS 다운로더가 담당합니다. 일일 Keepalive 기능은 무작위 시간에 `/member/profile`을 호출하여 계정을 활성 상태로 유지하고, 실패 시 푸시 알림을 보냅니다. API 키, 푸시 토큰, 비밀 설정은 절대 출력하지 않습니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add Amadeus1P048596/mteam-pt-codex-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

M-Team PT

scripts/mteam_pt.py에 있는 결정론적 CLI를 사용하세요. MTEAM_API_KEY를 환경 변수에서 읽으며, 비밀번호를 명령줄에 직접 받지 않습니다.

검색

실행:

python "{baseDir}/scripts/mteam_pt.py" search --query-base64 <UTF8_BASE64> --sort seeders --limit 10
  • 사용자 검색어를 Base64로 인코딩한 후 셸을 통해 전달하세요.
  • 기본값은 --sort seeders --direction desc입니다. 사용자가 요청한 정렬은 해당 호출에만 적용되며, 새로운 기본값으로 저장하지 마세요.
  • 지원하는 정렬 기준: seeders, leechers, completed, size, created, title, progress.
  • '只看免费'는 --discount FREE를 사용하고, 의도가 명확할 때 --mode movie|tvshow|normal을 사용하세요.
  • 스크립트가 반환한 번호가 매겨진 결과를 제시하세요. 제목, 크기, 포맷, 해상도, 시더/리처 수, 완료 수, 즐겨찾기 상태, 다운로드 진행률, 프로모션 및 유용한 선택 필드를 포함하세요.
  • 반환된 search_id를 현재 대화에서 유지하세요. 이후 번호 기반 작업이 표시된 목록에 정확히 바인딩됩니다.

번호가 매겨진 결과를 즐겨찾기

'숫자 N번째 결과를 즐겨찾기'는 해당 항목의 M-Team 컬렉션 상태를 변경하는 명시적 권한입니다. 실행:

python "{baseDir}/scripts/mteam_pt.py" favorite --pick N --search-id <SEARCH_ID>

'숫자 N번째 결과 다운로드'를 즐겨찾기로 재해석하지 마세요. 번호가 매겨진 목록이 없거나, 만료되었거나, 모호한 경우 추측하지 말고 다시 검색하세요. 스크립트가 반환한 정확한 제목과 토렌트 ID를 보고하세요. 사용자가 설정한 RSS 다운로더(이 스킬이 아님)가 이후 다운로드를 담당합니다.

명시적으로 즐겨찾기 취소/제거 요청이 있을 때만 unfavorite을 실행하세요.

기타 유용한 모드

  • 계정 상태 또는 수동 Keepalive: profile
  • 현재 즐겨찾기: favorites
  • 번호가 매겨진 한 결과의 전체 데이터: detail --pick N --search-id <SEARCH_ID>
  • 변경 없이 M-Team API 설정 확인: doctor
  • 무작위 Keepalive 일정 상태: schedule-status

선택적 일일 서비스는 /member/profile만 호출하며, 매일 Asia/Shanghai 시간대 [08:00, 24:00)에서 무작위 시간 하나를 선택하고 유지하며, 호환되는 인증된 푸시 엔드포인트를 통해 성공/최종 실패 메시지를 보냅니다. 해당 서비스를 설치, 수리 또는 점검할 때만 references/operations.md를 읽으세요. 엔드포인트나 결과 필드 정규화를 변경할 때만 references/api-notes.md를 읽으세요.

검색 결과는 M-Team 자체 collection 필드와 tracker/queryHistory 데이터를 사용하여 즐겨찾기/다운로드 상태를 확인합니다. 목록 보강을 위해 다운로더에 연결하지 마세요. 다운로더는 기존 RSS 자동화의 하위에만 위치합니다.

API 키, 푸시 토큰, 비밀을 포함하는 RSS URL, 또는 원시 개인 설정을 절대 출력하지 마세요. M-Team 쿠키 인증을 사용하지 마세요.

관련 스킬