social-auto-upload

social-auto-upload

은(는) 콘텐츠 크리에이터와 운영자가 국내외 주요 소셜 미디어 플랫폼에 비디오 콘텐츠를 한 번의 클릭으로 효율적으로 게시할 수 있도록 설계된 강력한 자동화 도구입니다.

이 프로젝트는 抖音 (Douyin), Bilibili, 小红书 (Xiaohongshu), 快手 (Kuaishou), 视频号 (Video Accounts), 百家号 (Baijiahao) 및 TikTok 등 플랫폼에 대한 비디오 업로드, 예약 게시 등의 기능을 구현했습니다.

각 플랫폼의 uploader 모듈을 결합하여 지원되는 플랫폼을 쉽게 구성 및 확장할 수 있으며, 예제 스크립트를 통해 빠르게 시작할 수 있습니다.

|
경시 AI(轻视AI): 한 문장으로 MG 애니메이션 제작, 지식, 과학 보급, 설명, 튜토리얼, 소개 등 유형의 비디오를 저비용으로 제작하기에 적합하며, 비디오 매트릭스, 계정 육성 등에 사용됩니다. 비용은 Seedance 등의 1% 수준입니다. 지금 등록 시 1500포인트를 증정합니다 |
|
ClawPower는 안정적이고 신뢰할 수 있는 AI 대규모 언어 모델 (LLM) 중계 서비스 제공업체로, Claude, GPT, Gemini 등 60개 이상의 대규모 모델 접속을 제공합니다. OpenClaw, Hermes 에이전트 자동화 시나리오, Claude Code, Codex 프로그래밍 도구 접속은 물론, 공식 계정, Xiaohongshu 콘텐츠 제작에 이르기까지 안정적이고 매끄러우며 장기적으로 사용할 수 있는 모델 서비스 경험을 얻을 수 있습니다. 공식 가격의 최저 30% 수준이며, 클릭하여 5달러 현금 체험권을 무료로 받으세요 |
|
스폰서가 되기: 본 프로젝트를 후원하고자 하신다면 왼쪽의 WeChat QR 코드를 스캔해 주세요 (추가 시 후원 목적을 명시해 주세요: 赞助).
|

플랫폼	로그인/계정 준비	비디오 업로드	이미지/텍스트 업로드	예약 게시	CLI	Skill	설명
抖音 (Douyin)	✅	✅	✅	✅	✅	✅	현재 메인 라인 리팩토링이 가장 완벽함
...

AI의 능력, 브라우저 에이전트 (browser agent) 등을 사용할 때, 매번 에이전트가 웹 페이지를 다시 해석하고, 스크린샷을 찍어 이해하며, 현장에서 판단하게 하는 것은 비효율적입니다. 이 프로젝트는 많은 검증을 거쳤으며, 업로드와 같이 빈도가 높고 반복적이며 지루한 작업은 스크립트와 프로그램에 맡겨 실행하도록 합니다.

만약 당신이 에이전트 클라이언트를 사용할 준비가 되지 않은 일반 사용자라면, 직접 확인하세요.

설치, 업데이트, 환경 준비는 이미 문서로 통합되었습니다:

AI의 발전은 의심의 여지가 없습니다. 이러한 설치와 사용을 마주했을 때 겁먹지 말고, 다양한 AI 에이전트 (AI Agent)에게 도움을 요청하세요.

만약 이 저장소를 OpenClaw, Codex, Claude Code에 직접 전달하여 설치 및 사용하고자 한다면:

먼저 저장소를 에이전트에게 주고, 그다음 이 시작 프롬프트 (startup prompt)를 함께 전달하세요:

이 프롬프트는 에이전트가 다음과 같이 수행하도록 안내합니다:

• 우선적으로 현재 메인 라인에 따라 프로젝트를 설치
• uv, sau CLI 및 skills/를 우선적으로 사용
• 먼저 bilibili, douyin, kuaishou, xiaohongshu 네 개 플랫폼의 엔트리(entry)가 사용 가능한지 확인
• CLI 사용법은 다음을 참조하세요: CLI 사용 설명
• OpenClaw, Codex, Claude Code / cc에서 본 프로젝트를 사용할 준비가 되었다면 다음을 먼저 보세요: Agent Bootstrap Prompt - agent / skill, Douyin Upload Skill 참조
• agent / skill은 Kuaishou Upload Skill 참조
• agent / skill은 Xiaohongshu Upload Skill 참조
• agent / skill은 Bilibili Upload Skill 참조
• 과거 Web 설명은 다음을 참조하세요: 과거 Web 버전 설명
• 기타 단일 플랫폼 skill 및 통합형 skill은 아직 개발 중입니다

requirements.txt는 현재 주로 과거 호환 경로를 위해 사용되며, 일반 사용자는 이를 우선적으로 사용할 필요가 없습니다.

2026.03.24

최근 저의 중점은 계속 창업에 있었고, 아직 완전히 실행되지 않은 프로젝트들이 있어 이 저장소에 한동안 특별히 많은 에너지를 투입하여 지속적으로 유지보수할 수 없었습니다.

이 프로젝트는 어느덧 9k+ star를 달성했고, 커뮤니티에는 이미 2000+ 명의 동료들이 함께하고 있습니다. 이것이 정말로 사람들에게 지속적인 도움을 주고 있는 것을 보니 마음이 매우 기쁘며, 항상 보내주신 지원과 피드백에 진심으로 감사드립니다.

그래서 잠시 멈추고 시간을 내어 이 프로젝트를 제대로 리팩토링 (refactoring)하고 최적화하기로 결정했습니다.

앞으로 이 저장소는 상대적으로 집중적인 업데이트 단계에 진입할 것입니다. 제가 지금 가장 먼저 하고 싶은 일은 다음과 같습니다:

• 더 은밀하고 안정적인 자동화 방안을 사용하여 플랫폼 탐지 리스크를 최대한 낮춤
• 몇몇 자주 사용되는 플랫폼의 이미지/텍스트 능력을 보완하고, 점진적으로 CLI화 및 Skill화를 완료
• 지속적으로 테스트하여 더 많은 skill 플랫폼에 출시함으로써, 여러분의 '랍스터, 게, 애벌레'가 AI 미디어의 마지막 관문을 통과할 수 있도록 지원

따라서 이전에 프로젝트 업데이트가 다소 느리다고 느끼셨다면, 하하하, 앞으로는 훨씬 빨라질 가능성이 높습니다. 계속해서 관심을 가져주시기 바랍니다. 최근에는 지속적인 수정, 지속적인 업데이트, 지속적인 리팩토링 단계가 될 것입니다.

프로젝트는 현재 전체적인 리팩토링을 진행 중이며, 현재 리팩토링 중점 사항은 다음과 같습니다:

• 각 플랫폼 uploader의 구조 수렴
• CLI 통합 접속
• OpenClaw, Codex, Claude Code 등의 도구를 향한 skill(기술)화
• patchright로 교체

드라이버를 교체하여 호환성과 은폐성을 향상시킵 - 메인 라인은 Headless(무두) 모드를 중심으로 추진합니다.

"Headless(무두) 모드"란 브라우저가 백그라운드에서 실행되어 가시적인 창이 뜨지 않지만, 자동화 프로세스는 정상적으로 실행되는 것을 의미합니다. 이는 CLI, 서버 사이드, 자동화 작업 및 Agent(에이전트) 시나리오에 더 적합합니다.

Web(웹) 관련 코드는 여전히 남아 있으나, 현재 메인 라인은 아니므로 즉시 실행을 보장하지 않으며 현재의 uploader/CLI와 완전히 동기화되어 있음을 보장하지 않습니다.

현재 Douyin(도인), Kuaishou(콰이쇼우), Xiaohongshu(샤오홍슈), Bilibili(비리비리)가 CLI에 통합되었습니다:

sau douyin login --account <account_name>
sau douyin check --account <account_name>
sau douyin upload-video --account <account_name> --file videos/demo.mp4 --title "예시 제목" --desc "예시 설명"
...

추가 설명:

creator와 같은 이름은 단지 예시 값이며, 실제 의미는 account_name입니다.

• 하나의 account_name은 하나의 계정 파일에 대응합니다. 여러 계정을 준비할 수 있으며, 계정 이름별로 작업을 병렬로 실행할 수 있습니다.
• 브라우저 플랫폼 통합 약속:
  • 영상은 title + desc + tags를 사용합니다.
  • 이미지/텍스트(图文)는 title + note + tags를 사용합니다.
• Bilibili CLI는 사용자가 biliup을 수동으로 설치할 것을 요구하지 않습니다.
• 관련 명령어를 처음 실행할 때 프로그램이 자동으로 biliup을 다운로드합니다.
• 이후 실행 시 상위 Release(릴리스)를 자동으로 확인하고 업데이트합니다.
• Bilibili 로그인은 사용자가 로컬의 실제 터미널에서 직접 실행하는 것을 권장합니다. 만약 터미널의 QR 코드가 온전하게 표시되지 않는다면, 현재 디렉토리의 qrcode.png를 직접 열어 스캔하십시오.

examples/ 디렉토리에는 두 가지 유형의 스크립트가 공존합니다:

• 현재 메인 라인 CLI 래핑(Wrapping) 예시
• 과거 직결 uploader 예시

Douyin, Kuaishou, Xiaohongshu, Bilibili의 경우, 현재 메인 라인에서는 위의 sau ... CLI를 우선적으로 사용합니다.
아래 스크립트들은 주로 과거 직결 uploader 예시 또는 디버깅 엔트리입니다:

examples/upload_to_douyin.py
examples/upload_video_to_bilibili.py
examples/upload_to_kuaishou.py
examples/upload_video_to_tencent.py
examples/upload_video_to_baijiahao.py
examples/upload_video_to_tiktok.py
examples/upload_video_to_xiaohongshu.py

이 프로젝트는 원래 제가 소셜 미디어 영상 게시를 자동화하여 관리하기 위해 만든 개인적인 도구입니다. 저의 주요 게시 전략은 하루 전에 예약 게시를 설정하는 것이므로, 프로젝트 내의 많은 예약 게시 관련 로직은 "다음 날"의 시간을 기준으로 계산됩니다.

즉시 게시가 필요하거나 다른 맞춤형 게시 전략이 필요하다면, 소스 코드를 연구하거나 커뮤니티에 질문해 주세요.

이미 구형이 되었으며, 현재 프로젝트를 빠르게 리팩토링 중입니다. 지금 여러분이 해야 할 일은 이 저장소를 여러분의 AI Agent(에이전트): Qwen Code, Codex, CC, OpenClaw 등에 전달하여 설치와 사용을 도와달라고 하는 것입니다.

더 자세한 문서와 설명은 social-auto-upload 공식 문서를 확인하세요.

☕ Donate as u like - 이 프로젝트가 도움이 되었다고 생각하신다면 후원을 고려해 주실 수 있습니다.

여러분도 독립 개발자나 기술 애호가로서 #기술수익화 #AI창업 #크로스보더이커머스 #자동화도구 #영상크리에이팅 등의 주제에 관심이 있다면, 커뮤니티에 참여하여 교류하기를 환영합니다.

WeChat(위챗) 공식 계정 💻 공식 계정을 팔로우하고 백그라운드에서 上传(업로드)를 입력하여 그룹 가입 방법을 확인하세요 |
교류 그룹 (공식 계정을 통해 획득) 📖 프로젝트가 유용하다고 생각하신다면 후원으로 지원을 고려해 주세요 |

Edan Lee 💻 📖 API 인터페이스와 Web(웹) 프론트엔드 관리 인터페이스를 캡슐화했습니다 (그룹 가입, 학습, 기업 컨설팅 등 방문 목적을 명시해 주세요) |

다음 내용을 포함한 다양한 형태의 기여를 환영합니다:

• Bug(버그) 보고 및 Feature(기능) 요청 제출.
• 코드 및 문서 개선.
• 사용 경험 및 튜토리얼 공유.

코드를 기여하고 싶다면 다음 단계를 따르세요:

• 본 저장소를 Fork(포크)합니다.
• 새로운 브랜치를 생성합니다 (git checkout -b feature/YourFeature 또는 bugfix/YourBugfix).
• 변경 사항을 커밋합니다 (git commit -m 'Add some feature').

)。 - 자신의 브랜치로 Push 합니다 (git push origin feature/YourFeature)

)。 - Pull Request를 생성합니다.

본 프로젝트의 Bilibili 업로드 기능은 오픈소스 프로젝트인 biliup의 기능을 기반으로 연동 및 캡슐화(Encapsulation)되었습니다.
biliup 프로젝트와 그 기여자분들이 제공한 기초 기능에 감사드립니다.

본 프로젝트는 현재 MIT License 오픈소스 라이선스를 채택하고 있습니다.

이 프로젝트가 도움이 되었다면, 지원의 의미로 ⭐ Star를 눌러주세요!

LINUX DO - The New Ideal Community