trademe-nz
Search public Trade Me NZ listings and help a normal signed-in user view and manage their own seller account through the ordinary Trade Me website. Use for public marketplace/property/motors/jobs disc
SKILL.mdskills/trademe-nz/SKILL.md
GitHubTrade Me NZ
Goal
Use the Python CLI for public search and deterministic seller-task planning. Perform seller reads and actions through the ordinary Trade Me website in a supported browser. Do not call member APIs or handle authentication material.
Public workflow
- Run
scripts/cli.py searchwith the narrowest--type. - Apply region, price, bedroom, and category filters.
- Run
listing IDfor public detail. - Use
--jsonfor structured output.
Seller workflow
Read references/browser-workflow.md completely before seller work.
- Run the relevant seller command with
--jsonto validate the target and get the starting website URL. - Use the Browser skill and the browser selected for the Trade Me URL.
- Reuse the normal website session without inspecting cookies, storage, request headers, tokens, profiles, or passwords.
- If Trade Me shows sign-in, email confirmation, CAPTCHA, or 2FA, keep the same browser open and let the user complete the step. Resume only when they say it is ready.
- Read Selling, Sold, Unsold, and listing details from visible page state.
- For a seller action, fill only the user-requested values and continue to Trade Me's review or confirmation screen.
- Stop before the final submit. Report the exact listing, changes, disposition, and any fee shown. Obtain a separate action-time confirmation.
- After confirmation, re-check the page and click the exact final control once.
- Verify the visible success state and re-read the affected seller page.
Never ask the user to paste a password, email code, OTP, cookie, token, or browser-storage value into chat or the CLI. Never copy or persist browser authentication data. Never bid, buy, pay, or manage another member's listings.
CLI
Run:
python3 skills/trademe-nz/scripts/cli.py <command> [flags]
Public commands:
search [query] --type TYPE [filters] [--json]listing ID [--raw] [--json]regions [--json]categories [--query TEXT] [--depth N] [--limit N] [--json]
Browser-backed seller task commands:
seller-summary [--json]my-selling [--json]my-sold [--json]my-unsold [--json]seller-listing ID [--json]prepare-edit ID [--json]validate-listing --data-file FILE [--json]create-listing --data-file FILE [--json]edit-listing --data-file FILE [--json]withdraw-listing ID [--sold --sale-price NZD] [--reason TEXT] [--json]relist-listing ID [--json]
Seller commands do not drive a browser by themselves and do not imply approval to submit a change. They produce a deterministic browser task for the agent to complete under this skill's authentication and confirmation rules.
Examples:
python3 skills/trademe-nz/scripts/cli.py search iphone --limit 5
python3 skills/trademe-nz/scripts/cli.py my-selling --json
python3 skills/trademe-nz/scripts/cli.py my-sold --json
python3 skills/trademe-nz/scripts/cli.py seller-listing 1234567890 --json
python3 skills/trademe-nz/scripts/cli.py edit-listing --data-file /private/listing.json --json
Resources
- CLI:
scripts/cli.py - Smoke test:
scripts/smoke_test.py - Browser authentication, page-reading, and action workflow:
references/browser-workflow.md - Public endpoint notes:
references/api-notes.md - Source declaration:
references/source-notes.md
Notes
- Public commands require no credentials.
- Seller work uses only visible, ordinary website UI in the selected browser.
- The browser owns its session; the skill never exports or persists it.
- Website labels and layout can change. Take a fresh DOM snapshot before constructing a locator, and use only locators grounded in that snapshot.
- Treat all inventory as a live snapshot.