Skip to main content
Generate /llms/{product-slug}.txt files for products and deploy to Vercel.
Standalone endpoint for manual use only. The cron job does NOT call this endpoint directly. Instead, discover-products calls generate_product_llms_txt internally for new products.

​
Use Cases

  • Regenerate product llms after content updates (manual)
  • Backfill llms files for products that were created without them
  • Manual trigger to refresh product llms content
  • Debugging and testing llms generation

​
Request Body

FieldTypeRequiredDescription
business_idstringYesClerk org ID
product_idsarrayNoSpecific product IDs to generate for. If omitted, generates for ALL products.

​
Response

{
  "status": "success",
  "products_processed": 5,
  "files_generated": 5,
  "files_deployed": 5,
  "products": ["Product A", "Product B", "Product C", "Product D", "Product E"]
}

​
How It Works

1. Fetch business entity and AI site project_name
2. Fetch products (all or filtered by product_ids)
3. For each product:
   - Get source_urls from entities.product_source_urls
   - Generate /llms/{slug}.txt content using Gemini
4. Deploy all generated files to Vercel (single deployment)
5. Return summary

​
Shared Service

This endpoint uses the shared generate_product_llms_txt service: 
src/app/shared/products/generate_llms_txt.py
The same service is used by:
  • Onboarding (GROUP 3b)
  • Cron (discover-products)

​
Product LLMs Architecture

FileLocationPurpose
Root llms.txt/llms.txtBusiness overview, key details, FAQs
Product llms/llms/{product-slug}.txtDetailed product info, features, pricing
This architecture scales to thousands of products:
  • Root llms.txt stays small (~3KB)
  • Each product gets its own file (~1-2KB)
  • Product files are fetched on-demand for AI article generation

​
Example Request

# Generate for all products
curl -X POST https://searchcompany-main.up.railway.app/api/cron/generate-product-llms-txt \
  -H "Content-Type: application/json" \
  -H "X-API-Key: search-company" \
  -d '{"business_id": "my-business-123"}'

# Generate for specific products
curl -X POST https://searchcompany-main.up.railway.app/api/cron/generate-product-llms-txt \
  -H "Content-Type: application/json" \
  -H "X-API-Key: search-company" \
  -d '{"business_id": "my-business-123", "product_ids": ["uuid-1", "uuid-2"]}'

​
Code Location

src/app/apis/cron/generate_product_llms_txt/
├── __init__.py
└── routes.py