name: DIYTutorial
description: |
  Extracts tutorial information from DIY sites like Instructables.
  IMPORTANT: Only include steps that contain actual actionable instructions.
  Skip and exclude any steps that are:
  - Introduction or overview steps (this goes in the overview field instead)
  - Conclusion, summary, or "final thoughts" steps
  - Steps asking users to subscribe, follow, or vote
  - Steps promoting other content or products
  - Steps with only images and no real instructions
  - "Supplies" or "Materials" steps (these go in materials_and_tools instead)
  Renumber the remaining steps sequentially starting from 1.

fields:
  - name: title
    type: string
    required: true
    description: The title of the tutorial/project

  - name: overview
    type: string
    required: true
    description: A descriptive summary of what this tutorial covers

  - name: image_url
    type: string
    description: URL of the main project image

  - name: difficulty
    type: string
    description: Difficulty level (Beginner, Intermediate, Advanced)

  - name: estimated_time
    type: string
    description: Estimated time to complete (e.g., "2-3 hours")

  - name: materials_and_tools
    type: array
    description: List of materials and tools needed
    items:
      type: object
      properties:
        item:
          type: string
          required: true
          description: Name of the material or tool
        quantity:
          type: string
          description: Amount needed
        notes:
          type: string
          description: Additional notes (sizes, alternatives)
        purchase_url:
          type: string
          description: URL to buy this item (Amazon search URL if specific link unavailable)

  - name: steps
    type: array
    description: Step-by-step instructions (actionable steps only)
    items:
      type: object
      properties:
        step_number:
          type: integer
          required: true
          description: Step number in sequence
        title:
          type: string
          required: true
          description: Title of this step
        instructions:
          type: string
          required: true
          description: Detailed instructions
        tips:
          type: string
          description: Tips or warnings for this step
        image_urls:
          type: array
          description: URLs of images for this step
          items:
            type: string
        helpful_links:
          type: array
          description: External resources (tutorials, videos, product links)
          items:
            type: object
            properties:
              title:
                type: string
                required: true
              url:
                type: string
                required: true
              type:
                type: string
                description: One of "tutorial", "video", "product", "reference"

export async function extractTutorial(
  url: string,
  apiUrl: string,
  apiKey: string
): Promise<RefyneResponse> {
  const response = await fetch(`${apiUrl}/api/v1/extract`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${apiKey}`,
    },
    body: JSON.stringify({
      url,
      schema: TUTORIAL_SCHEMA,
    }),
  });

  if (!response.ok) {
    const errorData = await response.json().catch(() => ({}));
    return {
      success: false,
      error: errorData.error || `API error: ${response.status}`,
    };
  }

  const data = await response.json();
  return {
    success: true,
    data: data.data || data,
  };
}

{
  "title": "Build a Simple Bookshelf",
  "overview": "Learn how to build a sturdy wooden bookshelf using basic tools and materials. Perfect for beginners looking to get into woodworking.",
  "image_url": "https://example.com/bookshelf.jpg",
  "difficulty": "Beginner",
  "estimated_time": "4-6 hours",
  "materials_and_tools": [
    {
      "item": "Pine boards (1x10x6ft)",
      "quantity": "4",
      "purchase_url": "https://www.amazon.com/s?k=pine+board+1x10"
    },
    {
      "item": "Wood screws (2 inch)",
      "quantity": "1 box",
      "purchase_url": "https://www.amazon.com/s?k=wood+screws+2+inch"
    },
    {
      "item": "Drill/Driver",
      "notes": "Cordless recommended",
      "purchase_url": "https://www.amazon.com/s?k=cordless+drill"
    }
  ],
  "steps": [
    {
      "step_number": 1,
      "title": "Cut the Side Panels",
      "instructions": "Measure and mark your pine boards at 36 inches. Use a circular saw or hand saw to make straight cuts.",
      "tips": "Clamp a straight edge as a guide for cleaner cuts",
      "helpful_links": [
        {
          "title": "How to Make Straight Cuts with a Circular Saw",
          "url": "https://www.youtube.com/results?search_query=straight+cuts+circular+saw",
          "type": "video"
        }
      ]
    },
    {
      "step_number": 2,
      "title": "Mark Shelf Positions",
      "instructions": "Measure and mark where each shelf will go. Space them evenly at 10 inches apart.",
      "image_urls": ["https://example.com/marking.jpg"]
    }
  ]
}