agent-park/n8n-workflows/AGENTS.md

n8n-workflows/ - Automation Workflows

OVERVIEW

n8n workflow definitions for automated data collection, project discovery, and keyword cloud generation. Workflows sync with production n8n instance.

KEY FILES

File	Purpose
keyword-cloud-workflow.json	Google Trends → Keywords API
README.md	Workflow documentation

PRODUCTION WORKFLOWS (n8n Instance)

Workflow	Status	Nodes	Purpose
项目描述向量化	✅ Active	11	Generate project embeddings for RAG
Github项目分析入库	⏸️ Inactive	16	Analyze & ingest GitHub repos
RAG项目搜索	✅ Active	6	AI-powered vector search
每日Github Trending项目计划新增	✅ Active	17	Daily trending → discovery tasks
Topic项目计划新增	⏸️ Inactive	16	Topic-based discovery

DATA FLOW

GitHub Trending API
        ↓
每日Github Trending项目计划新增
        ↓
ProjectDiscoveryTask (PENDING)
        ↓
Content Explorer Agent (Claude)
        ↓
Project Ingestion API
        ↓
项目描述向量化 → Embeddings (pgvector)
        ↓
RAG项目搜索 ← User Query

FOR AI AGENTS

When Modifying Workflows

1. Export from n8n UI → update JSON file
2. Document changes in README.md
3. Test with n8n-mcp tools before production

Related API Endpoints

• POST /api/discovery/tasks - Create discovery tasks
• POST /api/keyword-cloud/keywords - Bulk keyword upload
• POST /api/tags/maintenance - Tag cleanup (n8n integration)

Environment Variables (n8n)

• API_URL - Production API endpoint
• API_KEY - Same as WEBHOOK_API_KEY