实时热点洞察 (Inspo Radar)

实时热点洞察是一套 AI 驱动的热点分析与营销文案生成工具，面向多平台热点信息的快速采集、分析、结构化整理与创作建议输出。前端基于 Next.js，后端基于 PydanticAI 与 AG-UI 协议构建。

功能特性

• 🔥 热点捕捉：聚合多平台热搜与趋势信息
• 🧠 智能分析：自动完成话题热度、情绪与风险评估
• ✍️ 文案生成：根据话题生成营销型内容与创作建议
• 🌐 浏览器沙箱：集成 Playwright 的浏览器自动化能力
• 📊 可视化报告：结构化报告页面与下载能力

技术栈

• 前端：Next.js + React + Tailwind CSS
• 后端：Python 3.12 + PydanticAI
• 协议：AG-UI
• 自动化：Playwright（浏览器沙箱）

本地开发

依赖要求

• Node.js 20+
• Python 3.12+
• uv
• 任一前端包管理器：pnpm / npm / yarn / bun

本仓库默认忽略 lock 文件，避免多包管理器冲突。请在本地生成后保持不提交。

安装依赖

# 推荐
pnpm install

# 或者
npm install
yarn install
bun install

安装过程会自动初始化 Python 依赖。如需手动执行：

npm run install:agent

配置环境变量

在 agent/.env 中配置：

OPENAI_API_KEY=sk-...your-openai-key-here...

启动开发环境

pnpm dev

该命令会同时启动 UI 与 Agent 服务。

常用脚本

• dev：同时启动 UI 与 Agent
• dev:debug：启用 debug 日志
• dev:ui：仅启动前端
• dev:agent：仅启动后端
• build：构建前端产物
• start：启动生产服务
• lint：代码质量检查
• install:agent：安装 Python 依赖

目录结构

• src/app：Next.js 页面入口
• src/components：前端组件与报告渲染
• agent/src：后端 Agent 实现
• build.yaml / s.yaml / publish.yaml：Serverless Devs 部署配置

部署到阿里云

该项目已适配 Serverless Devs，可一键部署至 AgentRun + 函数计算。

前置条件

npm install -g @serverless-devs/s
s config add

部署步骤

npm run build
s deploy

部署时会提示选择地域、模型与浏览器沙箱模板。部署成功后控制台会输出访问地址。

关键配置文件

• s.yaml：部署与运行时配置
• publish.yaml：模板市场发布配置
• build.yaml：构建流程与缓存配置
• agent/requirements.txt：云端 Python 依赖

注意事项

• 文案与分析为 AI 生成内容，请在发布前人工审核。
• 需要有效的大模型 API Key 才能完整运行后端 Agent。

License

MIT

Troubleshooting

Agent Connection Issues

If you see "I'm having trouble connecting to my tools", make sure:

1. The PydanticAI agent is running on port 8000
2. Your OpenAI API key is set correctly
3. Both servers started successfully

Python Dependencies

If you encounter Python import errors:

cd agent
uv sync
uv run src/main.py