Upload a file, download the result

Requires a Pro license

Give the navigator a file with --navigator-file, and it attaches the file to the page’s file input; the download output type then saves the file the app hands back, here to leads-enhanced.csv. Fetch the sample input first: curl -O https://zshot-cli.com/example_assets/zrm/leads.csv. This example assumes you are using Anthropic as an LLM provider and have the key stored in the environment variable ANTHROPIC_API_KEY, but any supported provider works.

Run locally

zshot -t download -f leads-enhanced.csv \
  --navigate "Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV" \
  --navigator-file leads=./leads.csv \
  --navigator-credential username=success@zshot-app.com \
  --navigator-credential password=password \
  --navigator-type "anthropic://$ANTHROPIC_API_KEY@" \
  "https://zshot-cli.com/example_assets/zrm/"

{
  "url": "https://zshot-cli.com/example_assets/zrm/",
  "output_type": "download",
  "navigate": "Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV",
  "navigator_type": "anthropic://THE_ANTHROPIC_API_KEY@",
  "navigator_credential": {
    "username": "success@zshot-app.com",
    "password": "password"
  },
  "navigator_file": {
    "leads": "data:text/csv;base64,bmFtZSxjb21wYW55LGVtYWlsCk1hcmlzb2wgRmVycmVpcmEsR2xvYmV4IFRlY2hub2xvZ2llcyxtYXJpc29sLmZlcnJlaXJhQGdsb2JleC5leGFtcGxlCkRlc2hhd24gT2thZm9yLEluaXRlY2ggR2xvYmFsLGRlc2hhd24ub2thZm9yQGluaXRlY2guZXhhbXBsZQpQcml5YSBSYWdodW5hdGhhbixWYW5kZWxheSBIb2xkaW5ncyxwcml5YS5yQHZhbmRlbGF5LmV4YW1wbGUKVG9tYXMgQWd1aWxhcixQaWVkIFBpcGVyIFN5bmVyZ2lzdGljcyx0b21hcy5hZ3VpbGFyQHBpZWRwaXBlci5leGFtcGxlCkluZ3JpZCBCZXJncXZpc3QsV29ua2EgUHJvY3VyZW1lbnQsaW5ncmlkLmJlcmdxdmlzdEB3b25rYS5leGFtcGxlCktvZmkgTWVuc2FoLE5pbWJ1cyBHbG9iYWwsa29maS5tZW5zYWhAbmltYnVzLmV4YW1wbGUK"
  }
}

curl -X POST http://127.0.0.1:3000/ \
  -H "Content-Type: application/json" \
  -d '{"url":"https://zshot-cli.com/example_assets/zrm/","output_type":"download","navigate":"Log in, open the Lead Enhancer, upload the leads file, enhance it, and download the enhanced CSV","navigator_type":"anthropic://'$ANTHROPIC_API_KEY'@","navigator_credential":{"username":"success@zshot-app.com","password":"password"},"navigator_file":{"leads":"data:text/csv;base64,bmFtZSxjb21wYW55LGVtYWlsCk1hcmlzb2wgRmVycmVpcmEsR2xvYmV4IFRlY2hub2xvZ2llcyxtYXJpc29sLmZlcnJlaXJhQGdsb2JleC5leGFtcGxlCkRlc2hhd24gT2thZm9yLEluaXRlY2ggR2xvYmFsLGRlc2hhd24ub2thZm9yQGluaXRlY2guZXhhbXBsZQpQcml5YSBSYWdodW5hdGhhbixWYW5kZWxheSBIb2xkaW5ncyxwcml5YS5yQHZhbmRlbGF5LmV4YW1wbGUKVG9tYXMgQWd1aWxhcixQaWVkIFBpcGVyIFN5bmVyZ2lzdGljcyx0b21hcy5hZ3VpbGFyQHBpZWRwaXBlci5leGFtcGxlCkluZ3JpZCBCZXJncXZpc3QsV29ua2EgUHJvY3VyZW1lbnQsaW5ncmlkLmJlcmdxdmlzdEB3b25rYS5leGFtcGxlCktvZmkgTWVuc2FoLE5pbWJ1cyBHbG9iYWwsa29maS5tZW5zYWhAbmltYnVzLmV4YW1wbGUK"}}' \
  -o leads-enhanced.csv

The navigator attaches leads.csv to ZRM’s Lead Enhancer and clicks through to the enhanced download. zshot ≥ 0.25.0

Expected output

name,title,company,email,synergy_score
"Dr. Marisol Ferreira, PMP",Senior Director of Synergy Acceleration,Globex Technologies,marisol.ferreira@globex.example,75.3
"Mx. Deshawn Okafor, CSPO",Global Head of Alignment Acceleration,Initech Global,deshawn.okafor@initech.example,23.4
"Mx. Priya Raghunathan, PMP",Senior Director of Alignment Operations,Vandelay Holdings,priya.r@vandelay.example,26.3
Chief Tomas Aguilar,VP of Paradigm Innovation,Pied Piper Synergistics,tomas.aguilar@piedpiper.example,8.5
"Mx. Ingrid Bergqvist, PMP",Interim Alignment Innovation,Wonka Procurement,ingrid.bergqvist@wonka.example,18.3
Dr. Kofi Mensah (Synergy Certified),VP of Synergy Enablement,Nimbus Global,kofi.mensah@nimbus.example,47.5

The run drives ZRM’s Lead Enhancer, which enhances the uploaded leads entirely in the browser. Over the HTTP server, navigator_file values are base64 data URLs — the server never reads local paths.