Skip to content

README.es.md

Latest commit

 

History

History
315 lines (219 loc) · 10.9 KB

README.es.md

File metadata and controls

315 lines (219 loc) · 10.9 KB
Raw

🚀 Plataforma de Inteligencia de Creadores de Kickstarter

Plataforma profesional de recopilación, enriquecimiento y análisis de datos de más de 8,000 creadores de Kickstarter

Next.js TypeScript Python Supabase Tailwind CSS

🚀 Demo en Vivo • Características • Inicio Rápido • Stack • Configuración • Licencia

Idiomas: 🇺🇸 English • 🇧🇷 Português

🚀 Demo en Vivo

Pruébalo ahora: https://kickstarter.yuia.dev

📋 Tabla de Contenidos

🎯 Descripción General

La Plataforma de Inteligencia de Creadores de Kickstarter es un sistema profesional que recopila, enriquece y analiza automáticamente datos de más de 8,000 campañas futuras de Kickstarter. Proporciona inteligencia accionable para oportunidades de asociación, investigación de mercado y campañas de divulgación.

Capacidades principales:

  • Recopilación automatizada de datos de Kickstarter
  • Extracción de contactos con IA (correos electrónicos y formularios)
  • Extracción de perfiles de redes sociales (más de 10 plataformas)
  • Filtrado y búsqueda avanzados
  • Exportaciones profesionales a Excel
  • Interfaz web moderna con Next.js
  • Flujos de trabajo automatizados con GitHub Actions

👨‍💻 Sobre el Desarrollador

Desarrollado por Rafael Vieira (TechBeme)

GitHub Fiverr Upwork Email

Desarrollador Full-Stack y Especialista en Automatización con IA

Especializado en web scraping, sistemas de automatización, aplicaciones web modernas e integraciones de IA.

💼 Principales Especialidades

  • 🔍 Web Scraping y Extracción de Datos
  • ⚡ Automatización de Procesos y Flujos de Trabajo
  • 💻 Desarrollo Full-Stack (Next.js, React, Python, TypeScript)
  • 🤖 Integraciones de IA (OpenAI, Anthropic, sistemas RAG)
  • 📊 Diseño y Optimización de Bases de Datos
  • 🎨 Desarrollo de UI/UX Moderno

🌍 Idiomas

🇺🇸 Inglés • 🇧🇷 Português • 🇪🇸 Español

📬 Contacto

Email: contacto@techbe.me

✨ Características Principales

Recopilación y Enriquecimiento de Datos

  • Más de 8,000 Proyectos: Todas las campañas futuras de Kickstarter
  • Perfiles de Creadores: Bio, ubicación, estadísticas, historial de proyectos
  • Redes Sociales: Instagram, Twitter, LinkedIn, TikTok, YouTube, Discord, Patreon, Bluesky, Twitch, Facebook
  • Actualizaciones Automáticas: GitHub Actions se ejecuta cada hora

Extracción de Contactos con IA

  • Descubrimiento inteligente de correos electrónicos y formularios de contacto usando Firecrawl
  • Rotación automática de múltiples cuentas de API
  • Procesamiento paralelo (más de 100 workers simultáneos)
  • Lista de bloqueo de dominios fallidos

Interfaz Web

  • Búsqueda y filtrado avanzados
  • Paneles de creadores y proyectos
  • Gestión de divulgación (rastreo de estado, notas, etiquetas)
  • Funcionalidad de exportación a Excel
  • Diseño responsive con modo oscuro

📦 Lo Que Obtienes

1. Exportación Excel (creators_export.xlsx)

  • Una fila por creador con todos los proyectos
  • 22 columnas: info del creador, proyectos, ubicación, categorías, más de 10 URLs de redes sociales
  • ~8,000 creadores con datos completos
  • Formato profesional

2. Base de Datos PostgreSQL (Supabase)

  • creators: Perfiles, avatares, sitios web, redes sociales
  • projects: Detalles, datos de financiación, categorías, plazos
  • creator_outreach: Rastreo de estado, info de contacto, notas, etiquetas
  • firecrawl_accounts: Gestión de claves de API
  • firecrawl_blocked_domains: Lista de bloqueo compartida
  • pipeline_state: Rastrea última ejecución de extracción

3. Aplicación Web Moderna

  • Next.js 16 con TypeScript
  • Server Components para rendimiento
  • Tailwind CSS + shadcn/ui
  • Integración con Supabase

4. Automatización con GitHub Actions

  • Se ejecuta automáticamente cada hora
  • Sin necesidad de servidor
  • Artefactos guardados por 24 horas

🛠️ Stack Tecnológico

Backend (Python)

Tecnología Versión Propósito
Python 3.9+ Lenguaje de scripting principal
Cloudscraper Más reciente Bypass de anti-bot Cloudflare
Requests 2.32+ Cliente HTTP con retry
Pandas 2.2+ Procesamiento de datos & Excel
Supabase Client 2.22+ Operaciones de base de datos
Firecrawl 1.0+ Extracción de contactos con IA
openpyxl 3.1+ Generación de archivos Excel

Frontend (Next.js)

Tecnología Versión Propósito
Next.js 16.0+ Framework React con App Router
TypeScript 5.0+ Desarrollo type-safe
React 19.2+ Biblioteca de UI
Tailwind CSS 4.0+ Framework CSS utility-first
shadcn/ui Más reciente Componentes React de alta calidad
Radix UI Más reciente Componentes accesibles sin estilo
Lucide React Más reciente Biblioteca de iconos hermosa
TanStack Table 8.21+ Componente de tabla poderoso
Recharts 3.3+ Biblioteca de gráficos
xlsx 0.18+ Exportación Excel del lado del cliente
Zustand 5.0+ Gestión de estado ligera

Base de Datos e Infraestructura

Tecnología Propósito
PostgreSQL Base de datos de producción
Supabase Backend-as-a-Service
GitHub Actions Flujos de trabajo automatizados
Vercel Alojamiento del frontend

🚀 Inicio Rápido

Opción 1: GitHub Actions (Sin Configuración Local)

  1. Haz fork de este repositorio
  2. Activa las Actions en tu fork
  3. Añade GitHub Secrets: SUPABASE_URL y SUPABASE_KEY
  4. Espera la ejecución automática o activa manualmente
  5. Descarga resultados desde la pestaña Actions

Cambiar programación: Edita la expresión cron en .github/workflows/scheduled-scraper.yml

Opción 2: Ejecución Local

# Clona e instala
git clone https://github.com/TechBeme/kickstarter-scraper.git
cd kickstarter-scraper
pip install -r requirements.txt

# Solo Excel (sin base de datos)
python run.py --skip-supabase --skip-contacts

# Pipeline completo (requiere configuración de Supabase)
python run.py

Opción 3: Interfaz Web

# Instala dependencias
cd website
npm install

# Configura .env.local con credenciales de Supabase
# SUPABASE_URL=...
# SUPABASE_SERVICE_ROLE_KEY=...

# Ejecuta
npm run dev

⚙️ Configuración

Variables de Entorno

Crea .env en la raíz del proyecto:

SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_KEY=your-service-role-key

Comandos Comunes

# Pipeline completo
python run.py

# Solo Excel
python run.py --skip-supabase --skip-contacts

# Filtrar por fecha (últimos 90 días)
python run.py --days-filter 90

# Solo extracción de contactos
python run.py --contacts-only

# Limitar para pruebas
python run.py --enrich-limit 100

# Ver todas las opciones
python run.py --help

📝 Licencia

Licencia Propietaria - Todos los Derechos Reservados

Copyright © 2026 Rafael Vieira (TechBeme)

❌ Restricciones

  • Sin uso comercial
  • Sin modificaciones o trabajos derivados
  • Sin distribución o sublicenciamiento
  • Sin ingeniería inversa

✅ Uso Permitido

  • Ver código fuente con fines educativos
  • Ejecutar para uso personal y no comercial
  • Hacer fork solo para estudio personal

📧 Licenciamiento Comercial

Para uso comercial, contacta: contacto@techbe.me

⚠️ Descargo de Responsabilidad

Este proyecto es independiente y NO está afiliado a Kickstarter. Es una herramienta de terceros con fines educativos, de investigación e inteligencia de negocios.

  • Respeta los Términos de Servicio de Kickstarter
  • Rate limiting incorporado
  • Recopila solo datos públicamente disponibles
  • Los usuarios son responsables del cumplimiento de las leyes aplicables

🙏 Agradecimientos

Construido con Next.js, Supabase, Tailwind CSS, shadcn/ui, Firecrawl y otras increíbles tecnologías de código abierto.

Desarrollado por Rafael Vieira

GitHub Fiverr Upwork Email