homebrew-scrapeman

Official Homebrew tap for Scrapeman
The unlimited API client · built by Scrape.do

---

Install

brew install --cask scrape-do/scrapeman/scrapeman

That's it. One command. The app launches without any Gatekeeper warning — no "App is damaged" dialog, no right-click → Open dance, no manual shell incantation.

What's happening under the hood: Scrapeman is currently ad-hoc signed (Apple Developer ID notarization is on the long-term roadmap). Modern Homebrew always sets com.apple.quarantine on freshly downloaded casks, so without help the first launch would trigger Gatekeeper. The cask ships a postflight block that runs xattr -cr "#{appdir}/Scrapeman.app" immediately after install, stripping the quarantine bit and clearing the warning. Once Scrapeman is properly notarized, the postflight will be removed and there will be nothing left to do.

If you prefer to add the tap explicitly first:

brew tap scrape-do/scrapeman
brew install --cask scrapeman

Both forms install the same cask.

Upgrade

brew upgrade --cask scrapeman

Or upgrade everything at once:

brew upgrade

The cask file in this repo is bumped automatically on every Scrapeman release, so a single brew upgrade is enough to track the latest stable version. No in-app updater dialog, no manual download.

Uninstall

brew uninstall --cask --zap scrapeman

The --zap flag also wipes Scrapeman's preferences, history, cookies, and cached data:

• ~/Library/Application Support/Scrapeman — workspaces, history JSONL, cookie jar
• ~/Library/Preferences/com.scrapeman.app.plist
• ~/Library/Saved Application State/com.scrapeman.app.savedState
• ~/Library/Logs/Scrapeman
• ~/Library/Caches/Scrapeman, ~/Library/Caches/com.scrapeman.app

Drop --zap if you want to keep your workspaces and history.

Architectures

brew picks the right binary automatically based on your Mac:

CPU	Asset	Notes
Apple Silicon (M1 / M2 / M3 / M4)	Scrapeman-<version>-arm64.dmg	Native, no Rosetta
Intel x86_64	Scrapeman-<version>-x64.dmg	Native

If you've got both architectures on a single machine (e.g. external boot disk swaps), brew re-resolves on each install invocation — no manual override needed.

What is a Homebrew tap?

A tap is a Git repo that hosts third-party Homebrew formulas and casks. By the Homebrew protocol, a tap repo's name must follow the pattern homebrew-<name> — so brew tap scrape-do/scrapeman resolves to github.com/scrape-do/homebrew-scrapeman (this repo). The homebrew- prefix is mandatory; that's why this lives in a separate repository from the main Scrapeman repo instead of as a folder inside it.

Once you've added the tap, every brew command — install, upgrade, info, uninstall — knows about Scrapeman as if it were a first-party formula.

Why a self-hosted tap (and not homebrew/cask upstream)?

Scrapeman could eventually be submitted to homebrew/cask, the canonical Homebrew cask repository. Until then a self-hosted tap gives us:

• Same-day releases — every Scrapeman tag triggers an automatic cask bump in this repo, no upstream PR review queue
• Full control over --no-quarantine — we can document the exact install command that bypasses Gatekeeper, which an upstream cask would reject
• Direct upgrade path — every Scrapeman user gets the latest version via brew upgrade, no nag dialogs or in-app update banner needed
• Trademark and brand control — the cask name, desc, and homepage stay aligned with the project without review-board friction

Once Scrapeman is notarized and battle-tested in the wild, we may submit a properly-signed cask to upstream homebrew/cask. This tap will keep working forever either way.

Verifying a build manually

If you want to check the SHA256 of a release asset against the cask:

# 1. Read the SHA from the cask
brew cat scrapeman | grep sha256

# 2. Download the dmg and compute its SHA
curl -L -o /tmp/Scrapeman.dmg \
  https://github.com/scrape-do/scrapeman/releases/download/v0.2.1/Scrapeman-0.2.1-arm64.dmg
shasum -a 256 /tmp/Scrapeman.dmg

The two should match. Every release pipeline run uploads the same dmg twice — once to the GitHub Release and once into this cask via the bump automation — so the SHA in the cask is always the SHA you'd compute from the actual download.

Reporting issues

• App bugs / feature requests → scrape-do/scrapeman issues
• Cask-only bugs (install fails, wrong arch, broken symlink, etc.) → scrape-do/homebrew-scrapeman issues

When in doubt, open it in the main repo — we'll move it if needed.

Links

• App repo: https://github.com/scrape-do/scrapeman
• Landing page: https://scrapeman.app
• Releases: https://github.com/scrape-do/scrapeman/releases
• Scrape.do (parent company): https://scrape.do

License

This tap (the cask formula and this README) is Apache 2.0 licensed alongside Scrapeman itself. See LICENSE for the full text.

---

_{Made with ❤️, ☕ and a lot of vibe-coding by humans + AI at Scrape.do}