cochesnet-cli_skill

Overview

This skill provides command-line access to coches.net listings using the cochesnet CLI. It lets you search the marketplace and fetch detailed ad data, returning human-friendly tables or JSON for scripting. Use it when you need exact CLI commands, flags, and environment configuration to automate or script coches.net queries.

How this skill works

The CLI exposes two primary commands: search and listing. search runs a marketplace query with optional limit and page flags; listing fetches full details for a known ad ID. Add --json to either command to receive machine-readable output suitable for piping into other tools or CI jobs.

When to use it

• Search coches.net listings from a terminal or script.
• Retrieve full ad details for a specific ad ID.
• Automate marketplace monitoring and data extraction.
• Produce JSON output for downstream processing or storage.
• Debug or reproduce queries with exact CLI flags and environment.

Best practices

• Use --json for scripting and check the process exit code to detect failures.
• Set environment variables (COCHESNET_BASE_URL, COCHESNET_APP_VERSION, etc.) to match your environment or testing endpoint.
• Limit results with --limit and paginate with --page to avoid large payloads.
• Validate ad IDs before calling listing to minimize unnecessary requests.
• Capture stderr and exit codes in automation to handle rate limits and network errors.

Example use cases

• Quick search: cochesnet search "bmw" --limit 5 to preview current listings in the terminal.
• Paginated scraping: cochesnet search "toyota" --page 2 --json and pipe results into jq for filtering.
• Detailed lookup: cochesnet listing 58229053 --json to fetch full seller, description, and URL.
• Monitoring: run scheduled searches with --json and compare hashes to detect new listings.
• Integration: feed JSON output into a database import script or a notification workflow.