langchain-ai/social-media-agent

Social Media Agent – 주요 기능

목적: 웹 URL을 입력받아 페이지 콘텐츠를 추출하고, Twitter 및 LinkedIn 게시물 초안을 자동으로 작성하는 엔드 투 엔드 "에이전트"입니다. 워크플로우는 human-in-the-loop(인간 개입) 방식입니다. LLM이 초안을 생성하면, 실제로 게시하기 전에 사용자가 편집, 승인 또는 거부할 수 있습니다.

주요 구성 요소

• LLM 백엔드 – Anthropic API를 통해 Anthropic의 Claude(또는 기타 Anthropic 모델)를 사용하여 게시물을 작성합니다.
• 웹 스크레이핑 – FireCrawl이 기사, 블로그, GitHub 리포지토리, YouTube 트랜스크립트 등을 가져옵니다.
• 인증 및 게시 – Arcade 서비스(또는 사용자의 Twitter/LinkedIn 개발자 자격 증명)가 OAuth, 토큰 저장 및 실제 게시를 위한 API 호출을 처리합니다.
• 상태 및 오케스트레이션 – LangGraph 그래프가 전체 파이프라인(스크레이핑 → 요약 → 초안 작성 → 인간 검토 → 게시)을 실행합니다. 그래프는 langgraph-cli를 사용하여 로컬에서 실행할 수 있으며 LangGraph Cloud에 배포할 수도 있습니다.
• 선택적 통합 – 이미지 저장용 Supabase, 채널을 통해 URL을 수집하기 위한 Slack, 리포지토리별 콘텐츠를 위한 GitHub.

실행 방법 (빠른 시작)

1. 리포지토리를 클론하고 의존성을 설치합니다 (yarn install).
2. .env.quickstart.example를 .env로 복사하고 필요한 키(Anthropic, FireCrawl, Arcade, LangSmith(선택 사항))를 입력합니다.
3. LangGraph CLI를 설치합니다 (pip install langgraph-cli).
4. 인메모리 LangGraph 서버를 시작합니다: yarn langgraph:in_mem:up.
5. yarn generate_post를 실행합니다. 이 스크립트는 샘플 LangChain 블로그 URL에 대해 generate_post 그래프를 호출합니다. 결과는 LangSmith 또는 Agent Inbox UI에 나타납니다.

전체 기능 설정에는 다음이 추가됩니다:

• Google Vertex AI를 통한 YouTube 비디오 처리.
• Supabase를 통한 이미지 선택/업로드.
• 채널에서 URL을 가져와 자동으로 그래프를 호출하는 Slack 기반 cron 작업.
• 전체 미디어 업로드 지원을 위한 직접적인 Twitter/LinkedIn OAuth (Arcade 대신).
• GitHub URL 파싱 및 조직 수준의 LinkedIn 게시.

커스터마이징

• src/agents/generate-post/prompts/ 아래의 프롬프트 파일을 통해 비즈니스 컨텍스트, 게시물 예시, 구조 지침 및 스타일 가이드라인을 변경할 수 있습니다.
• 게시물 스타일 프롬프트를 통해 코드 수정 없이 톤과 형식을 제어할 수 있습니다.

전형적인 사용 사례 마케팅 팀이 지정된 Slack 채널에 링크를 올립니다. 매일 실행되는 cron 작업이 에이전트가 링크를 스크레이핑하고, 브랜드에 맞는 간결한 트윗과 LinkedIn 업데이트 초안을 작성하여 Agent Inbox에 보여주면, 사용자가 빠르게 편집한 후 자동으로 게시됩니다.

이런 분들께 추천합니다

• 소셜 미디어 카피 생성을 자동화하려는 콘텐츠 마케터.
• HITL 워크플로의 준비된 LangGraph 예시를 원하는 개발자.
• 이미 LangChain/LangGraph를 사용 중이며 소셜 플랫폼으로 확장하고자 하는 팀.

---

요약: Social Media Agent는 LLM 생성, 웹 스크레이핑, OAuth 인증 및 human-in-the-loop UI를 결합하여 Twitter와 LinkedIn 게시를 자동화하는 방법을 보여주는 실제 실행 가능한 프로젝트입니다.