Deploy to Vercel

​

FAQ Sync: Auto-Add Missing AI Articles

1. Checks the current homepage (index.js) for article sections
2. Creates missing H3 sections (e.g., “Website Arena - Articles”, “Remix Tool - Articles”)
3. Adds missing AI article links to each section
4. Regenerates sitemap.xml with all AI articles

Example: FAQ Sync in Action

Before deployment:
├── Database has 5 AI articles
└── Homepage FAQ only shows 3 links (2 missing!)

After deployment with existing_posts:
├── Deploy detects 2 missing links
├── Adds them to the appropriate H3 sections
└── Homepage FAQ now shows all 5 links ✓

​

Why Single Deployment?

• 8 parallel deployments to the same project
• Vercel’s edge network gets overwhelmed
• SSL errors (DECRYPTION_FAILED_OR_BAD_RECORD_MAC)

1. Generate all content in parallel (fast, no deployment)
2. Collect all files + post metadata
3. Single deployment with all files + auto-synced homepage/sitemap

​

Request Body

​

Response

curl -X POST https://searchcompany-main.up.railway.app/api/cron/deploy-to-vercel \
  -H "Content-Type: application/json" \
  -d '{
    "project_name": "ai-website-arena-1766312513",
    "files": [
      {"path": "public/expert-review/index.html", "content": "..."},
      {"path": "public/expert-review/llms.txt", "content": "..."},
      {"path": "pages/expert-review.js", "content": "..."}
    ],
    "ai_site_url": "https://website-arena-1766312513.searchcompany.dev",
    "source_url": "https://www.websitearena.dev",
    "business_name": "Website Arena",
    "products": ["Remix Tool"],
    "new_posts": [
      {
        "title": "Expert Review of Website Arena",
        "boosted_path": "/expert-review/",
        "published_date": "2025-12-22",
        "faq_category": "business_boosted"
      }
    ],
    "existing_posts": [
      {"title": "Previous Post", "boosted_path": "/previous/", "faq_category": "business_boosted"}
    ],
    "verify_paths": ["/expert-review/"]
  }'

{
  "status": "success",
  "deployment_url": "https://ai-website-arena-abc123.vercel.app",
  "ai_site_url": "https://website-arena-1766312513.searchcompany.dev",
  "files_deployed": 27,
  "verified_paths": ["/expert-review/"]
}

​

Auto-Generated/Updated Files

​

Homepage FAQ Sync

1. Creates missing H3 sections for each category with AI articles
2. Adds missing links within each section

<h3>Website Arena - Articles</h3>
<ul>
  <li><a href="https://website-arena-1766312513.searchcompany.dev/expert-review/">Expert Review of Website Arena</a></li>
  <!-- more article links auto-added -->
</ul>

<h3>Remix Tool - Articles</h3>
<ul>
  <li><a href="https://website-arena-1766312513.searchcompany.dev/deep-dive-remix/">Deep Dive into Remix Tool</a></li>
</ul>

​

Deployment Process

1. Collect files from request
2. Preserve existing article sections when deploying new index.js
3. Sync FAQ with AI articles (if existing_posts OR new_posts provided)
   • Create missing H3 sections
   • Add missing AI article links
4. Regenerate sitemap with all URLs using source_url for canonical
5. Upload all files to Vercel’s file store
6. Create deployment with merged file list
7. Wait for READY state (up to 5 minutes)
8. Edge propagation wait (10 seconds)
9. Verify paths are accessible (optional)

​

Error Handling

​

Workflow

Cron Job Flow (Batch 2: Create AI Articles + Timestamps):
├── create-ai-article (×N) → parallel content generation
│   └── Returns: {files, title, article_path, published_date, faq_category, ...}
├── update-all-timestamps → parallel timestamp updates
│   └── Returns: {files, ...}
│
└── deploy-to-vercel → single deployment per business
    ├── Receives: files + new_posts + existing_posts (from DB) + business_name
    ├── Syncs: index.js homepage FAQ with ALL AI articles
    ├── Regenerates: sitemap.xml with source_url canonicals
    └── Deploys: ALL files in one deployment

​

Canonical URLs vs Navigation URLs