social-media-agent

环境要求

• Node.js 环境与 yarn 包管理器
• Python 环境（用于 pip 安装 langgraph-cli）
• Anthropic API Key（通用 LLM）
• LangSmith API Key（本地运行 LangGraph Server 所需，免费）
• FireCrawl API Key（网页抓取）与 Arcade API Key（社交平台授权）

安装与启动步骤

1. 1安装项目依赖

   在克隆好的项目目录下执行 yarn install，安装 TypeScript 项目所需的全部依赖。

   yarn install

   复制

2. 2安装 LangGraph CLI

   LangGraph 服务需要通过官方 CLI 启动，使用 pip 安装该命令行工具。

   pip install langgraph-cli

   复制

3. 3检查 CLI 是否可用

   执行版本命令确认 LangGraph CLI 安装成功，若报错说明 PATH 或 Python 环境有问题。

   langgraph --version

   复制

4. 4填写环境变量

   在项目根目录 .env 中填入各平台密钥：Anthropic、LangSmith、FireCrawl、Arcade，以及 TWITTER_USER_ID、LINKEDIN_USER_ID、USE_ARCADE_AUTH。

5. 5启动 LangGraph 服务

   按 README 的 Start the LangGraph Server 小节启动本地服务；LangSmith API Key 必须有，否则服务无法在本地运行。

6. 6授权社交账号

   使用自建 Twitter 应用时运行授权服务，浏览器打开 http://localhost:3000 点击 Login with Twitter，把终端输出的 token 与 tokenSecret 写回 .env。

   yarn start:auth

   复制

关键配置

如何确认成功

执行 langgraph --version 能正常输出版本号；若使用自建 Twitter 应用，浏览器可打开 http://localhost:3000 并完成 Twitter 授权登录。

常见问题

注意事项

• Twitter 应用的回调地址必须设置为 http://localhost:3000/auth/twitter/callback，LinkedIn 为 http://localhost:3000/auth/linkedin/callback。
• 完整模式需要 Anthropic、Google Vertex AI、LangSmith、FireCrawl、Arcade 以及 Twitter、LinkedIn、GitHub、Supabase 等多个账号，建议先用基础模式跑通。
• 发帖到 LinkedIn 公司主页需要个人账号具备 ADMINISTRATOR、DIRECT_SPONSORED_CONTENT_POSTER 或 RECRUITING_POSTER 角色，并需提交表单等待审核。
• README 的 Quickstart 与 Advanced Setup 共用同一套安装命令，区别只在所需账号与功能范围。