> ## Documentation Index
> Fetch the complete documentation index at: https://intunedhq.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart: Build a scraper with Intuned Agent

In this quickstart, you'll use Intuned Agent to build a scraper that extracts job postings from Apple's career page. By the end, you'll have a working scraper that handles pagination and extracts structured data—all generated from a simple prompt.

## What is Intuned Agent?

Intuned Agent is an AI agent that builds, edits, and maintains browser automation Projects. It runs inside the Intuned platform with a real browser, full access to the platform via the [Intuned CLI](/main/05-references/cli/overview), and works in the background as long as needed.

Learn more about Intuned Agent's full capabilities in the [overview](/main/02-intuned-agent/overview).

## Prerequisites

* An active Intuned account ([sign up here](https://app.intuned.io)). No credit card required—Intuned has a free plan.

## What you'll build

You'll instruct Intuned Agent to build a scraper that scrapes [Apple's career page](https://jobs.apple.com/en-us/search?location=united-states-USA). The scraper will:

* Extract job postings with a defined JSON schema
* Paginate through the full job list
* Capture detailed information for each posting

## Create your first scraper

<Steps>
  <Step title="Enter your prompt" icon="wand-magic-sparkles">
    1. Go to [app.intuned.io/agent](https://app.intuned.io/agent).
    2. Paste the prompt below into the input and send it.

    ```md Prompt theme={null}
    I want to scrape job postings from [Apple career page](https://jobs.apple.com/en-us/search?location=united-states-USA)

    FILTER: No need to apply any filters

    For each job, I need:

    job_title: string
    product_and_service: string
    post_date: string (iso format)
    description: string
    summary: string
    apply_url: string
    role_number: string
    ```

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/agent-starting.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=8eb3b1b4b45e8d272a0cfe924b4678f0" alt="Intuned Agent session starting" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/agent-starting.png" />
    </Frame>

    **Expected result:** The agent starts a session and begins exploring the target website.
  </Step>

  <Step title="Answer the agent's questions" icon="comments">
    As the agent explores the site, it asks clarifying questions to shape the scraper—such as which language to use, how to handle pagination, and what to name the project. Answer each question as it appears.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/language-selection.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=d8938fe2be73e5c9e3f1e4ff37cad11a" alt="Agent asking which language to use" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/language-selection.png" />
    </Frame>

    <Tip>When asked about pagination, **Configurable max pages** is the recommended option—it gives you control at runtime without rebuilding the scraper.</Tip>
  </Step>

  <Step title="Approve the plan" icon="clipboard-check">
    Once the agent has finished exploring, it presents a full plan: the start URL, entity structure, navigation instructions, and schema. Review it and select **Approve Plan** to proceed, or **Suggest Changes** to adjust.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/agent-plan.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=1e048c03fb261cf4f102a54a77d6be24" alt="Agent plan ready for approval" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/agent-plan.png" />
    </Frame>

    **Expected result:** The agent begins building your scraper.
  </Step>

  <Step title="Wait for the agent to build" icon="gears">
    The agent writes the code, runs end-to-end tests, and validates the output. This typically takes 30–60 minutes.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/agent-progress.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=6df8c7fa0c53241f138d6e3359f0ea31" alt="Agent building and running E2E tests" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/agent-progress.png" />
    </Frame>
  </Step>

  <Step title="Review results and deploy" icon="rocket">
    When the agent finishes, it shows a work summary with a description of what was built and the E2E test results. Select **View Code** to inspect the generated code, or **Merge Branch** to deploy.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/agent-done.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=44907ab7604c2c85a0df60a00aa96ab6" alt="Agent work summary" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/agent-done.png" />
    </Frame>

    Select **View Code** and open the **Artifacts** tab to inspect the actual scraped data from the agent's test run before deploying.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/check-output.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=c69ab4541b528dcbd20b582e70596b34" alt="Artifacts panel showing scraped results" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/check-output.png" />
    </Frame>

    When you're satisfied, select **Merge Branch**. In the dialog, choose **Merge & Deploy** to create an Intuned project and deploy it immediately, or **Merge only** to merge the code without deploying.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/bhb38akfgMoZ2D8J/assets/intuned-agent/agent-flow/merge-and-deploy.png?fit=max&auto=format&n=bhb38akfgMoZ2D8J&q=85&s=407b598ac399b3437efc86a458b79671" alt="Merge and deploy dialog" width="2880" height="2048" data-path="assets/intuned-agent/agent-flow/merge-and-deploy.png" />
    </Frame>

    **Expected result:** Your scraper is deployed and ready to run via API, scheduled Jobs, or direct triggers.
  </Step>

  <Step title="Run your scraper" icon="circle-check">
    Once deployed, navigate to your project and select the **Runs** tab. Select **Start Run** to trigger your scraper.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/1bhAGMPY5Uewkdvk/assets/intuned-agent/agent-flow/start-run.gif?s=f96ab8ee0caa8acf04c5081a451f39f6" alt="Project runs page with Start Run button" width="1440" height="1024" data-path="assets/intuned-agent/agent-flow/start-run.gif" />
    </Frame>

    **Expected result:** The run completes successfully. You can see the input parameters, output result, and the full attempts timeline.

    <Frame>
      <img src="https://mintcdn.com/intuned-dev/1bhAGMPY5Uewkdvk/assets/intuned-agent/agent-flow/run-success.png?fit=max&auto=format&n=1bhAGMPY5Uewkdvk&q=85&s=6f92284fd948dbd294d3f7bd8d88f752" alt="Successful scraper run showing extracted job postings" width="1392" height="1021" data-path="assets/intuned-agent/agent-flow/run-success.png" />
    </Frame>
  </Step>

  <Step title="(Optional) Iterate on your scraper" icon="rotate">
    Start a new conversation and select **Pick project** to load your scraper. You can then ask the agent to add filters, change the schema, fix selectors, or adjust the scraping logic.

    **Example prompt:**

    ```markdown theme={null}
    Add a parameter to filter by product and service. Examples:
    Apple Ads
    AirPods
    ```
  </Step>
</Steps>

## What's next?

* **[Intuned Agent](/main/02-intuned-agent/overview)** — Learn more about Intuned Agent's capabilities, including editing existing projects and fixing failed runs.

* **[Jobs](/main/02-features/jobs-batched-executions)** — Jobs are the common way to run scrapers. Configure a schedule (daily, hourly, or custom) and define a sink to send your scraper results to a webhook, S3 bucket, or other destination.

* **[Authentication](/main/02-features/auth-sessions)** — For scrapers that require login, Intuned provides built-in authentication support. You define how to log in and how to verify a session, and Intuned handles the rest—validating sessions before runs, reusing them when possible, and recreating them when expired.

* **[Monitoring and traces](/main/02-features/observability-monitoring-logs)** — Every run generates detailed logs, browser traces, and session recordings. Use these tools to debug failures, verify your scraper is working correctly, and understand what happened during execution.

* **[Online IDE](/main/02-features/online-ide)** — Learn more about the Intuned IDE, which you can use to manually edit the scraper you just created.
