{"id":50412346,"url":"https://github.com/cskwork/reddit-scraper-tool","last_synced_at":"2026-05-31T04:04:57.088Z","repository":{"id":300317189,"uuid":"1005858418","full_name":"cskwork/reddit-scraper-tool","owner":"cskwork","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-21T01:26:00.000Z","size":33,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-21T02:30:37.718Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cskwork.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-21T00:42:34.000Z","updated_at":"2025-06-21T01:26:03.000Z","dependencies_parsed_at":"2025-06-21T02:30:41.485Z","dependency_job_id":"bf8d0d34-7481-4a4a-8bdd-76aafd6d5fd4","html_url":"https://github.com/cskwork/reddit-scraper-tool","commit_stats":null,"previous_names":["cskwork/reddit-scraper-tool"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cskwork/reddit-scraper-tool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Freddit-scraper-tool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Freddit-scraper-tool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Freddit-scraper-tool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Freddit-scraper-tool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cskwork","download_url":"https://codeload.github.com/cskwork/reddit-scraper-tool/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cskwork%2Freddit-scraper-tool/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33718498,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T04:04:56.302Z","updated_at":"2026-05-31T04:04:57.082Z","avatar_url":"https://github.com/cskwork.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Reddit 스마트 콘텐츠 스크래퍼\r\n\r\nAI 기반 Reddit 콘텐츠 필터링 및 분석 도구\r\n\r\n## 기능\r\n\r\n- 키워드 기반 Reddit 게시물 검색\r\n- Ollama LLM을 사용한 지능형 콘텐츠 필터링\r\n- 관련성 점수 기반 품질 평가\r\n- 검색 기록 및 결과 저장\r\n- 아름다운 터미널 UI (Rich 라이브러리)\r\n- AI 인사이트 추출\r\n\r\n## 빠른 시작\r\n\r\n### Windows\r\n\r\n```powershell\r\n# 1. 설치\r\nsetup.bat\r\n\r\n# 2. 실행\r\nrun.bat\r\n\r\n# 3. 설치 확인 (선택사항)\r\npython test_install.py\r\n```\r\n\r\n### macOS/Linux\r\n\r\n```bash\r\n# 1. 설치\r\nchmod +x setup.sh\r\n./setup.sh\r\n\r\n# 2. 실행\r\n./run.sh\r\n\r\n# 3. 설치 확인 (선택사항)\r\npython test_install.py\r\n```\r\n\r\n## 상세 설치 가이드\r\n\r\n### 사전 요구사항\r\n\r\n1. **Python 3.8+**\r\n\r\n   - Windows: [python.org](https://python.org)에서 다운로드\r\n   - macOS: `brew install python3`\r\n   - Linux: `sudo apt install python3 python3-pip python3-venv`\r\n\r\n2. **Reddit API 자격증명**\r\n\r\n   - [Reddit Apps](https://www.reddit.com/prefs/apps)에서 앱 생성\r\n   - \"script\" 타입 선택\r\n   - client_id와 client_secret 메모\r\n\r\n3. **Ollama (선택사항, AI 필터링용)**\r\n   - Windows/macOS/Linux: [ollama.ai](https://ollama.ai/download)에서 다운로드\r\n   - 설치 후: `ollama pull gemma3:1b`\r\n\r\n### 설치 과정\r\n\r\n설치 스크립트(`setup.bat` 또는 `setup.sh`)가 자동으로:\r\n\r\n- Python 가상환경 생성\r\n- 필요한 패키지 설치\r\n- `.env` 파일 생성\r\n- 의존성 확인\r\n\r\n### 설정\r\n\r\n설치 후 `.env` 파일을 편집하여 Reddit API 자격증명 입력:\r\n\r\n```\r\nREDDIT_CLIENT_ID=your_actual_client_id\r\nREDDIT_CLIENT_SECRET=your_actual_client_secret\r\n```\r\n\r\n## 사용법\r\n\r\n### 대화형 모드 (권장)\r\n\r\n```bash\r\n# Windows\r\nrun.bat\r\n\r\n# macOS/Linux\r\n./run.sh\r\n```\r\n\r\n메뉴에서 선택:\r\n\r\n1. 새로운 검색\r\n2. 검색 기록 보기\r\n3. 상위 게시물 보기\r\n4. 설정\r\n5. 종료\r\n\r\n### CLI 모드\r\n\r\n```bash\r\n# 기본 검색\r\nrun.bat -k \"python\" \"programming\"\r\n./run.sh -k \"python\" \"programming\"\r\n\r\n# 특정 서브레딧에서 검색\r\nrun.bat -k \"machine learning\" -s \"MachineLearning\" -l 100\r\n./run.sh -k \"machine learning\" -s \"MachineLearning\" -l 100\r\n```\r\n\r\n### CLI 옵션\r\n\r\n- `-k, --keywords`: 검색할 키워드 (필수)\r\n- `-s, --subreddits`: 검색할 서브레딧 (기본: all)\r\n- `-l, --limit`: 가져올 게시물 수 (기본: 50)\r\n- `-i, --interactive`: 대화형 모드 실행\r\n\r\n## 문제 해결\r\n\r\n### Python이 설치되어 있지 않음\r\n\r\n- 각 플랫폼별 Python 설치 가이드 참조\r\n\r\n### Reddit API 오류\r\n\r\n- `.env` 파일의 자격증명 확인\r\n- Reddit 앱이 활성화되어 있는지 확인\r\n\r\n### Ollama 연결 실패\r\n\r\n- Ollama가 실행 중인지 확인: `ollama list`\r\n- 필요한 모델 다운로드: `ollama pull gemma3:1b`\r\n\r\n## 데이터 저장\r\n\r\n모든 데이터는 `reddit_scraper.db` SQLite 데이터베이스에 저장:\r\n\r\n- 검색 기록\r\n- 필터링된 게시물\r\n- AI 분석 결과\r\n- 관련성 점수\r\n\r\n## 주요 컴포넌트\r\n\r\n- `reddit_client.py`: Reddit API 통신\r\n- `content_analyzer.py`: AI 기반 콘텐츠 분석\r\n- `database.py`: SQLite 데이터베이스 관리\r\n- `terminal_ui.py`: Rich 터미널 인터페이스\r\n- `main.py`: 메인 애플리케이션\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcskwork%2Freddit-scraper-tool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcskwork%2Freddit-scraper-tool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcskwork%2Freddit-scraper-tool/lists"}