🎴 Tarot Matrix Generator & Market Trend Scraper

The premium all-in-one tool for tarot deck creators and spiritual product entrepreneurs.

Stop spending weeks manually writing image prompts for 78 tarot cards. Stop guessing which tarot styles sell on Kickstarter and Etsy. This Actor does both — powered by GPT-4o and built for production.

---

🔥 What Problem Does This Solve?

Creating a full tarot deck from scratch involves two painful steps:

Step 1 — Creative Production: You need a unique, detailed image prompt for every single one of the 78 cards. Writing them manually takes days. Hiring a prompt engineer costs hundreds of dollars.

Step 2 — Market Validation: Before investing in art, you need to know what styles are trending, what price points work, and what backers are actually asking for on crowdfunding platforms.

This Actor eliminates both bottlenecks in a single run.

---

✨ Two Powerful Modes

🎴 Mode 1: MATRIX_GENERATOR — AI Tarot Prompt Engine

Generates a complete set of 78 production-ready image prompts (one per tarot card) using OpenAI GPT-4o.

Anti-Token Strategy: The 78 cards are split into 4 sequential API calls to prevent JSON truncation:

• Batch 1: Major Arcana (22 cards)
• Batch 2: Suit of Wands (14 cards)
• Batch 3: Suit of Cups (14 cards)
• Batch 4: Swords + Pentacles (28 cards)

Each card receives a structured output object ready for Midjourney, DALL-E, Stable Diffusion, or any image AI.

📈 Mode 2: MARKET_SCRAPER — Trend Intelligence Engine

Scrapes real market data from Kickstarter and Etsy to identify what's selling, what's trending, and what your customers actually want.

• Kickstarter: Hits the internal JSON API directly (faster, fewer Compute Units) and runs GPT-4o-mini semantic analysis on backer comments to extract buying motivations.
• Etsy: Uses PlaywrightCrawler for full JavaScript rendering to extract live product listings, prices, and review counts.

---

📊 Sample Output — MATRIX_GENERATOR

Field	Example Value
id	0
name	The Fool
arcana	major
suit	null
visualStyle	Cyberpunk
colorPalette	Neon brillante
deckType	Rider-Waite
generatedAt	2026-07-01T10:00:00Z

Sample imagePrompt:

"A young androgynous figure in a neon-lit cyberpunk cityscape, standing at the edge of a skyscraper rooftop, one foot raised, glowing briefcase in hand. Electric neon palette — magenta, cyan and acid green. Holographic butterflies swirl. Rider-Waite iconography fused with cyberpunk aesthetic. Ultra-detailed digital illustration, 8K resolution."

Sample negativePrompt:

"blurry, watermark, text, signature, low quality, pixelated, amateur, flat colors"

---

📊 Sample Output — MARKET_SCRAPER (Kickstarter)

{
  "platform": "kickstarter",
    "id": 123456789,
      "name": "The Cosmic Neon Tarot Deck",
        "blurb": "78 cards of neon-lit cosmic energy for the modern mystic",
          "category": "Tabletop Games",
            "creator": "Studio Arcana",
              "pledged": 45820,
                "goal": 5000,
                  "backers": 612,
                    "fundingPercentage": 916,
                      "state": "successful",
                        "aiCommentInsights": "{\"supportReasons\": \"Backers love the unique neon aesthetic and the inclusion of a guidebook\", \"positiveFeatures\": [\"Holographic foiling\", \"Thick cardstock\", \"Inclusive imagery\"], \"concerns\": \"Some backers requested a larger card size\", \"sentimentScore\": 9}",
                          "scrapedAt": "2026-07-01T10:00:00Z"
                          }
                          ```

                          ---

                          ## ⚙️ How To Use

                          ### Step 1: Choose Your Mode
                          Select `MATRIX_GENERATOR` to create prompts, or `MARKET_SCRAPER` to analyze the market.

                          ### Step 2: Configure Your Input

                          | Parameter | Type | Required | Default | Description |
                          |-----------|------|----------|---------|-------------|
                          | `mode` | Select | ✅ | MATRIX_GENERATOR | Operating mode |
                          | `openaiApiKey` | Secret | ✅ | — | Your OpenAI API key (sk-...) |
                          | `visualStyle` | String | ❌ | Cyberpunk | Art style for all card prompts |
                          | `colorPalette` | String | ❌ | Neon brillante | Dominant color palette |
                          | `deckType` | Select | ❌ | Rider-Waite | Iconographic tradition |
                          | `platforms` | Array | ❌ | ["kickstarter","etsy"] | Platforms to scrape |
                          | `maxItemsPerPlatform` | Integer | ❌ | 20 | Max results per platform |
                          | `searchQuery` | String | ❌ | tarot deck | Search keyword for scraper |
                          | `proxyConfiguration` | Proxy | ❌ | Apify Proxy | Proxy settings |

                          ### Step 3: Export Your Data
                          All results are saved automatically to the default Dataset. Export instantly to **Excel, CSV, or JSON** from your Apify Dashboard.

                          ---

                          ## 💡 Use Cases

                          - **Tarot deck creators** launching on Kickstarter or Etsy who need a full prompt library before hiring an illustrator
                          - **AI art studios** producing tarot content at scale for print-on-demand platforms
                          - **Product researchers** analyzing the spiritual products niche for crowdfunding opportunities
                          - **Marketing teams** at spiritual brands tracking competitor pricing and sentiment on Etsy

                          ---

                          ## 🔧 Technical Specs

                          - **Runtime:** Node.js 18+ with TypeScript (ESM)
                          - **AI Model:** GPT-4o (generation), GPT-4o-mini (sentiment analysis)
                          - **Crawler:** PlaywrightCrawler (Etsy) + Axios (Kickstarter API)
                          - **Proxy:** Native Apify Proxy integration
                          - **Output:** Apify Dataset (auto-exportable to Excel, CSV, JSON)
                          - **Memory:** 512 MB minimum, 4 GB maximum

                          ---

                          ## 🚀 Ready to Launch Your Deck?

                          Run this Actor once and walk away with 78 fully-crafted image prompts AND a complete competitive intelligence report — in under 10 minutes.

                          **Your next bestselling tarot deck starts here.**