First Pipeline Run

This tutorial walks you through running the prospect pipeline — the most common starting point for agency operations. By the end, you will have a ranked list of local business leads written to your Notion database.

Prerequisites

Before starting, make sure:

• The dashboard is running at http://localhost:3000
• The pipeline server is running at http://localhost:8750
• You are logged in to the dashboard
• Your ANTHROPIC_API_KEY is set in pipeline-server/.env

Option A: Run from the Dashboard

1. Navigate to Mission Control in the sidebar
2. Find the Prospect pipeline card
3. Enter a search query, for example: barbershops in Buckhead
4. Click Run

The pipeline will start and you will see streaming output in the dashboard. The pipeline server spawns a Claude Code process that:

1. Searches for businesses matching your query
2. Visits each business website and audits it for mobile responsiveness, page speed, design quality, and SEO
3. Attempts to find contact emails from the website and search results
4. Scores each lead as HOT, WARM, or COLD based on site quality and need
5. Writes HOT and WARM leads with confirmed emails to your Notion Leads database
6. Saves the full results to ~/agency-workspace/.output/prospect-[area]-[type].md

Option B: Run via API

curl -X POST http://localhost:8750/pipelines/run \
  -H "Authorization: Bearer YOUR_PIPELINE_SERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"pipeline": "prospect", "args": "barbershops in Atlanta"}'

Replace YOUR_PIPELINE_SERVER_TOKEN with the token from your pipeline-server/.env file.

What to Expect

The prospect pipeline typically takes 3-5 minutes to complete. The output is a ranked table:

At the bottom, you will see a lead summary:

• Total found: how many businesses were discovered
• With email: how many had confirmed emails (these get written to Notion)
• Without email: excluded from Notion (may require walk-in outreach)

Checking the Output

In the Dashboard

Navigate to the Reports section to see the generated output file.

On Disk

ls ~/agency-workspace/.output/prospect-*

In Notion

If you configured your Notion Leads database, open it to see the new lead entries. Each entry includes the business name, industry, area, score, website URL, contact email, and suggested pitch angle.

Caching

The prospect pipeline caches results for 7 days. If you run the same query again within that window, it will show cached results and ask whether to use them or run fresh.

Next Steps

After your first prospect run:

• Run audit [business name] on a HOT lead to generate a detailed site audit
• Run outreach [business name] to draft a personalized email
• Explore the other 17 pipelines available in GridWork HQ

Troubleshooting

Pipeline starts but produces no output:

• Verify ANTHROPIC_API_KEY is set in pipeline-server/.env
• Verify Claude Code CLI is installed: claude --version
• Check pipeline server logs for errors

Dashboard shows "Pipeline server unreachable":

• Verify the pipeline server is running: curl http://localhost:8750/health
• Check that PIPELINE_SERVER_TOKEN matches in both .env.local and pipeline-server/.env

Leads not appearing in Notion:

• Verify NOTION_API_KEY and NOTION_LEADS_DB are set
• Verify the Notion database is shared with your integration
• Only HOT and WARM leads with confirmed emails are written to Notion