Skip to content

README.md

Latest commit

 

History

History
234 lines (154 loc) · 8.6 KB

README.md

File metadata and controls

234 lines (154 loc) · 8.6 KB

Threads Sweeper

Threads Sweeper는 Threads에서 계정을 모아 두고, 한 번에 차단할 수 있게 도와주는 Chrome 확장 프로그램입니다.

기본 기능은 차단입니다. 원하면 신고도 함께 하기 체크박스를 켜서, 차단 전에 신고를 먼저 시도할 수 있습니다.

이런 분께 도움이 됩니다

  • 특정 계정의 팔로워 목록에서 여러 계정을 모아 차단하고 싶은 분
  • 유해 계정으로 보이는 계정을 하나씩 직접 차단하기 번거로운 분
  • 차단한 계정 목록을 CSV 파일로 남겨두고 싶은 분
  • 나중에 실패한 계정만 다시 확인하거나 재시도하고 싶은 분
  • 같은 문제를 다루는 신뢰할 수 있는 사람과 계정 목록을 공유해야 하는 분

이 도구가 하는 일

Threads Sweeper는 크게 네 가지 일을 합니다.

  1. Threads 화면에 보이는 팔로워 계정을 읽어옵니다.
  2. 읽어온 계정을 차단 대기열에 모아둡니다.
  3. 대기열에 있는 계정을 백그라운드 작업창에서 차단합니다.
  4. 원하면 차단 전에 신고도 먼저 시도합니다.

중요한 점이 있습니다. 지금 보고 있는 프로필이 바로 차단되는 것은 아닙니다.

지금 보고 있는 프로필은 수집을 시작하는 출발점입니다. 그 프로필의 팔로워 목록을 열고 스크롤하면, 화면에 보이는 팔로워들이 차단 대기열에 추가됩니다. 실제로 처리되는 계정은 이 차단 대기열에 들어간 계정들입니다.

설치 방법

  1. 이 저장소를 다운로드하거나 클론합니다.

    git clone https://github.com/your-username/threads-sweeper.git

  2. Chrome 주소창에 아래 주소를 입력합니다.

    chrome://extensions

  3. 오른쪽 위의 개발자 모드를 켭니다.

  4. 압축해제된 확장 프로그램 로드를 누릅니다.

  5. 다운로드한 threads-sweeper 폴더를 선택합니다.

  6. Chrome 오른쪽 위 확장 프로그램 목록에서 Threads Sweeper를 엽니다.

기본 사용법

1. Threads에서 대상 프로필 열기

먼저 Threads에서 팔로워를 수집할 프로필로 이동합니다.

예시:

https://www.threads.net/@username

그다음 해당 프로필의 팔로워 목록을 직접 엽니다.

2. 팔로워 수집하기

  1. Threads Sweeper 사이드패널을 엽니다.
  2. 수집 시작 버튼을 누릅니다.
  3. Threads의 팔로워 목록을 천천히 아래로 스크롤합니다.
  4. 화면에 보이는 계정들이 자동으로 차단 대기열에 추가됩니다.
  5. 충분히 모았다면 다시 버튼을 눌러 수집을 멈춥니다.

같은 계정이 여러 번 보이더라도 중복으로 추가되지 않습니다.

3. 대기열 확인하기

차단을 시작하기 전에 차단 대기열을 꼭 확인하세요.

대기열에 들어간 계정이 실제 처리 대상입니다. 실수로 들어간 계정이 있다면 초기화 후 다시 수집하는 것이 안전합니다.

4. 직접 계정 추가하기

팔로워 수집을 하지 않고 직접 계정을 넣을 수도 있습니다.

입력창에 계정 이름을 넣고 추가를 누르세요.

여러 개를 한 번에 넣을 수도 있습니다.

user1 user2,@user3

띄어쓰기나 쉼표로 구분하면 됩니다. @는 있어도 되고 없어도 됩니다.

5. 신고 여부 선택하기

기본값은 차단만 하기입니다.

신고도 하고 싶다면 신고도 함께 하기 체크박스를 켜세요.

체크박스를 켜면 대기열에 있는 각 계정에 대해 다음 순서로 동작합니다.

  1. 신고 시도
  2. 차단 시도
  3. 결과 표시

현재 신고 사유는 MVP 기능으로 고정되어 있습니다.

계정 신고
Threads에 허용되지 않는 콘텐츠
폭력, 혐오 또는 학대
혐오 발언 또는 상징

신고에 실패하더라도 차단은 계속 시도합니다. 단, Threads에서 요청이 너무 많다고 판단하는 상황이 감지되면 작업을 멈추고 나중에 다시 시도할 수 있게 합니다.

6. 차단 시작하기

  1. 동시 작업 수를 선택합니다.
  2. 처음 사용할 때는 1개를 추천합니다.
  3. 차단 시작 버튼을 누릅니다.
  4. 신고 체크박스를 켠 경우 버튼이 신고 후 차단 시작으로 바뀝니다.
  5. 작업이 끝날 때까지 Chrome을 닫지 마세요.

동시 작업 수를 높이면 더 빠를 수 있지만, 실패나 제한이 생길 가능성도 높아집니다. 익숙하지 않다면 1개 또는 2개부터 사용하세요.

CSV 저장이란?

CSV는 엑셀이나 구글 스프레드시트에서 열 수 있는 표 파일입니다.

Threads Sweeper에서 CSV 저장을 누르면 현재 대기열과 처리 결과가 파일로 저장됩니다.

파일 이름은 보통 아래처럼 저장됩니다.

threads_report_block_list_YYYY-MM-DD.csv

CSV 안에는 이런 열이 들어갑니다.

Username,ReportStatus,BlockStatus,Timestamp

각 열의 뜻은 다음과 같습니다.

  • Username: 계정 이름
  • ReportStatus: 신고 상태
  • BlockStatus: 차단 상태
  • Timestamp: 대기열에 추가된 시간

CSV를 활용하는 예시

CSV 파일은 단순한 기록용으로도 좋지만, 여러 방식으로 활용할 수 있습니다.

  • 차단한 계정 목록을 나중에 확인하기
  • failed 상태인 계정만 골라서 다시 시도하기
  • skipped 상태를 보고 신고 없이 차단만 한 계정 구분하기
  • 구글 스프레드시트에서 계정 이름을 정렬하거나 필터링하기
  • 날짜별 CSV를 비교해서 새로 발견된 계정 찾기
  • 신뢰할 수 있는 사람과 처리 목록을 공유하기
  • 추가 메모 열을 만들어 왜 처리했는지 직접 기록하기

CSV에는 자동 판단 결과가 들어가지 않습니다. 계정이 왜 문제인지, 어떤 맥락이 있는지는 사용자가 직접 판단하고 필요하면 별도 메모로 관리해야 합니다.

상태값 설명

화면과 CSV에는 다음과 같은 상태가 나올 수 있습니다.

  • pending: 아직 처리 전
  • reported: 신고 완료
  • skipped: 신고를 하지 않음
  • blocked: 차단 완료
  • failed: 실패

최종 성공 기준은 차단 성공입니다. 신고는 선택 기능이라 차단 결과와 따로 표시됩니다.

자주 헷갈리는 점

현재 보고 있는 프로필이 바로 차단되나요?

아닙니다. 현재 프로필은 팔로워를 모으기 위한 출발점입니다. 실제 처리 대상은 차단 대기열에 들어간 계정입니다.

신고를 꼭 해야 하나요?

아닙니다. 기본은 차단만 하는 것입니다. 신고도 필요할 때만 신고도 함께 하기를 켜세요.

신고에 실패하면 차단도 실패하나요?

아닙니다. 신고에 실패해도 차단은 계속 시도합니다.

계정을 직접 입력해서 처리할 수 있나요?

네. 수동 입력창에 계정 이름을 넣고 추가를 누르면 됩니다.

CSV는 꼭 저장해야 하나요?

아닙니다. 선택 사항입니다. 다만 나중에 확인하거나 실패한 계정만 다시 처리하려면 저장해두는 것이 좋습니다.

주의사항

  • 이 확장 프로그램은 Threads 공식 API가 아니라 브라우저 화면을 자동으로 조작합니다.
  • Threads 화면 구성이 바뀌면 수집, 신고, 차단이 실패할 수 있습니다.
  • 너무 많은 계정을 빠르게 처리하면 제한이 걸릴 수 있습니다.
  • 이 도구는 유해 계정을 자동으로 판단하지 않습니다. 어떤 계정을 처리할지는 사용자가 직접 결정해야 합니다.
  • 차단이나 신고는 되돌리기 어렵거나 번거로울 수 있으니 대기열을 먼저 확인하세요.
  • 괴롭힘, 협박, 스토킹, 법적 분쟁이 있다면 별도로 증거를 보관하고 전문가에게 도움을 요청하는 것도 고려하세요.

개발 관련 정보

  • Chrome Extension Manifest V3 기반입니다.
  • 별도의 빌드 과정 없이 사용할 수 있습니다.
  • 백그라운드 작업창은 chrome.scripting으로 제어됩니다.
  • 현재 신고/차단 기능을 위해 추가 Chrome 권한은 필요하지 않습니다.

폴더 구조

threads-sweeper/
├── manifest.json
├── src/
│   ├── background/
│   │   └── service-worker.js
│   ├── content/
│   │   ├── content.js
│   │   └── content.css
│   ├── popup/
│   │   ├── popup.html
│   │   ├── popup.css
│   │   └── popup.js
├── icons/
└── README.md

라이선스

MIT License