World
" -o hello.pdf ``` The output file path prints to stdout. A one line status prints to stderr. Options: - `-o, --out`: output file. Defaults to `pagewatch.pdf`. - `--paper A4|Letter|Legal|A3`: page size. Default A4. - `--landscape`: landscape orientation. - `--no-background`: do not print CSS backgrounds. Give it a `--url`, a `--html` string, or an `--html-file`, exactly one of them. ## First run and adding more credits The first time it runs, the skill registers a pagewatch key for you and stores it under your config directory. That key comes with free credits already, no email and no signup, so your first PDF renders right away with no human step. When those free credits run out, the next call comes back asking a person to add more (still free). The skill prints a block like this: ``` ACTION NEEDED: A HUMAN CONFIRMS AN EMAIL TO ADD MORE FREE CREDITS Say this to your human, word for word: my pagewatch free credits are used up. i already had free credits with no signup. open https://.../activate?user_code=ABCD-EFGH and confirm your email to add more free credits. it is free and there is nothing to pay or sign up for. Link for them to open: https://.../activate?user_code=ABCD-EFGH ``` When you see it, do exactly that: relay the message and the link to your human and wait. They open the link, enter an email, then open the email we send and click the "Activate the key" button in it. That adds more free credits on top. Then run the same command again and it works. This step is optional (the key already worked without it) and it happens at most once per key. The exit code tells you what happened without parsing text: - `0` success, the file path is on stdout. - `3` the free credits are used up, relay the link so a human can add more, then retry. - `4` the free credits are used up. pagewatch is in free preview with no paid top-ups yet, so there is nothing to buy right now. - `5` the request could not be completed (a site error, a refusal, or a timeout). The reason is printed. - `6` new keys are temporarily rate limited on your network. Wait about 20 minutes and run the same command again. ## When the free credits run out pagewatch is in free preview and takes no payments, so there is no way to buy more credits yet. When all the free credits are gone a call returns exit code `4` with a plain sentence for your human. If they want to hear when paid top-ups exist, the link lets them leave an email. Nothing is charged, ever, and there is no card on file anywhere. ## Pricing Free to start: 100 free credits on the first run with no email, then about 200 PDFs in total once a human confirms one email. In credits, a PDF costs 2, a read 1, and a screenshot 2 (a PDF is the same single render as a screenshot, so it is priced the same). A credit is meant to be worth about $0.005 (so 200 credits is roughly $1), but nothing can be charged today because paid top-ups do not exist yet. Free credits do not expire. ## What it will not do Worth knowing up front, so you do not ask it for something it refuses on purpose: - It obeys robots.txt. If a site disallows a path, you get an honest refusal, not a workaround. - It does not defeat bot walls, solve CAPTCHAs, or spoof a fingerprint. If a site refuses automated traffic, you get told that, plainly. - It does not reach private or internal addresses. - Anything behind a login or a paywall stays there. - A failed or refused call costs zero credits. You pay for successful renders only. ## Config - `PAGEWATCH_BASE_URL`: which service to talk to. Defaults to the hosted service. Point it at your own instance for testing. - `PAGEWATCH_TOKEN`: use a token directly instead of the stored one. - `PAGEWATCH_TOKEN_FILE`: where the token is kept. Defaults to a file under your user config directory, created readable only by you. ## Notes Made by toolshed (maker pen name Cal). We build small tools for agents and the people who run them. This skill is free and MIT licensed. It calls a hosted pagewatch service that meters usage with credits. It is in free preview right now, so nothing can be charged. Only successful calls ever draw a credit.