Twitter 个性分析 🐦🧠

Twitter 个性分析是一款网络应用程序，它会分析你的 Twitter 账号，并利用 Wordware AI Agent 打造一份个性化的性格画像。该项目借助前沿的人工智能技术，为用户提供对其 Twitter 个人形象的独特洞察。🚀

你可通过访问 此 Wordware 链接 来探索这款应用中使用的 AI 助手及提示词。

项目设置 🛠️

要在本地机器上搭建 Twitter 个性分析项目，请按照以下步骤操作：

1. 克隆仓库 📂：使用你喜欢的方式（例如 Git Bash、GitHub Desktop 或命令行）将 Twitter 个性分析的仓库从 GitHub 克隆到本地。
2. 安装依赖 📦：进入项目目录并运行 npm install，以安装所有必需的依赖项。
3. 环境变量 🔐：根据 .env.example 文件，在项目根目录下创建一个名为 .env.local 的文件。以下是需要设置的一些关键环境变量：
   • DATABASE_URL：你的 Neon 数据库 URL（请勿将这些凭据暴露给浏览器）。
   • WORDWARE_API_KEY：用于 AI 处理的 Wordware API 密钥。
   • WORDWARE_PROMPT_ID、WORDWARE_ROAST_PROMPT_ID、WORDWARE_FULL_PROMPT_ID、WORDWARE_PAIR_PROMPT_ID：本项目的特定 Wordware 提示词 ID。
   • NEXT_PUBLIC_BASE_URL：应用的基础 URL（例如，本地开发时可设为 http://localhost:3000）。
   • LOOPS_API_KEY：用于新闻通讯功能的 Loops API 密钥。
   • NEXT_PUBLIC_POSTHOG_KEY、NEXT_PUBLIC_POSTHOG_HOST、POSTHOG_PROJECT_ID、POSTHOG_PERSONAL_API_KEY：PostHog 分析配置。
   • STRIPE_SECRET_KEY、STRIPE_WEBHOOK_SECRET、STRIPE_PRICE_ID、STRIPE_PRODUCT_ID：Stripe 支付配置。
   • NEXT_PUBLIC_PAIR_PASSWORD：配对功能的密码。
   • 对于网页抓取，你需要至少提供以下其中一项（我们采用多种方式作为备用机制）：
     • TWITTER_API_TOKEN 和 TWITTER_COOKIE：Twitter API 配置。
     • APIFY_API_KEY：Apify 网页抓取服务的 API 密钥。
     • SOCIALDATA_API_KEY：SocialData API 密钥。

完整所需的环境变量列表，请参考 .env.example 文件。

.env.local 文件示例内容（请替换为你自己的实际值）：

Twitter Personality 快速上手指南

Twitter Personality 是一个基于 Wordware AI Agent 的 Web 应用，能够分析你的 Twitter 账号并生成个性化的性格画像。本指南将帮助中国开发者快速在本地部署该项目。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统: Windows, macOS 或 Linux
• Node.js: 建议安装 LTS 版本 (v18 或更高)
• 包管理器: npm (随 Node.js 安装) 或 yarn/pnpm
• 数据库: 需要拥有一个 Neon 数据库实例
• API 密钥:
  • Wordware API Key
  • (可选但推荐) 数据抓取服务密钥：Apify API Key 或 SocialData API Key，或者原生的 Twitter API Token/Cookie。

提示：国内开发者在安装依赖时若遇到网络问题，可配置淘宝镜像源加速： npm config set registry https://registry.npmmirror.com

安装步骤

1. 克隆项目

使用 Git 将代码仓库克隆到本地：

git clone <repository-url>
cd <project-directory>

(请将 <repository-url> 替换为实际的 GitHub 仓库地址)

2. 安装依赖

在项目根目录下运行以下命令安装所需依赖：

npm install

3. 配置环境变量

在项目根目录创建 .env.local 文件。你可以复制示例文件作为模板：

cp .env.example .env.local

编辑 .env.local 文件，填入你的实际配置信息。以下是关键变量说明：

# 数据库配置 (Neon DB)
DATABASE_URL=your_neon_database_url

# Wordware AI 配置
WORDWARE_API_KEY=your_wordware_api_key
WORDWARE_PROMPT_ID=your_prompt_id
WORDWARE_ROAST_PROMPT_ID=your_roast_prompt_id
WORDWARE_FULL_PROMPT_ID=your_full_prompt_id
WORDWARE_PAIR_PROMPT_ID=your_pair_prompt_id

# 应用基础 URL (本地开发通常为)
NEXT_PUBLIC_BASE_URL=http://localhost:3000

# 其他服务配置 (根据需求填写)
LOOPS_API_KEY=your_loops_api_key
NEXT_PUBLIC_POSTHOG_KEY=your_posthog_key
NEXT_PUBLIC_POSTHOG_HOST=your_posthog_host
POSTHOG_PROJECT_ID=your_project_id
POSTHOG_PERSONAL_API_KEY=your_posthog_personal_key

# Stripe 支付配置 (如需测试支付功能)
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=your_stripe_webhook_secret
STRIPE_PRICE_ID=your_stripe_price_id
STRIPE_PRODUCT_ID=your_stripe_product_id

# Pair 功能密码
NEXT_PUBLIC_PAIR_PASSWORD=your_secure_password

# 数据抓取配置 (至少配置其中一组，系统会自动降级尝试)
# 方案 A: Twitter 原生
TWITTER_API_TOKEN=your_twitter_token
TWITTER_COOKIE=your_twitter_cookie

# 方案 B: Apify (推荐)
APIFY_API_KEY=your_apify_api_key

# 方案 C: SocialData
SOCIALDATA_API_KEY=your_socialdata_api_key

基本使用

完成上述配置后，即可启动开发服务器：

1. 启动项目 在终端运行：

   npm run dev
   

2. 访问应用 打开浏览器访问 http://localhost:3000。

3. 开始分析 在界面中输入你想要分析的 Twitter 用户名（Handle），系统将调用 Wordware AI 代理处理数据，并生成该用户的性格分析报告。

---

注：你可以在 Wordware Playground 查看本项目使用的具体 AI Agent 逻辑和 Prompt 设计。