autolisting

Files (5)

• SKILL.md
• openai.yaml · agents/
• manifest.json
• listing-contract.md · references/
• setup.md · references/

SKILL.md (first lines)

# AutoListing Agent

Use only the configured `autolisting` MCP server. Authentication is the scoped API key in the MCP client's `Authorization: Bearer ...` header. Never request, display, repeat, or store the key in chat.

This MCP integration supports product listings only. It does not create, inspect, edit, or render Video Ads. `generate_listing_video` creates a short video belonging to the product listing and is not the Video Ads feature.

## Required workflow

1. Call `get_account`. Report available and reserved credits. Do not continue if `listings:create` is absent.
2. Collect and confirm the product URL, price, currency, stock, image count, variation structure, and whether a listing video is required.
3. Call `create_listing`. This only starts generation; it never publishes.
4. Return the `listing_reference` immediately. Poll `get_listing` with that exact reference until `ready=true`, without creating a duplicate.
5. Present the generated texts, warnings, image references/URLs, listing-video reference/URL, and full variation model.
6. If the user wants publication, call `list_shops`, confirm the provider, shop, and `draft` versus `publish`, then call `publish_listing` separately. Never infer permission to publish from the earlier creation request.
7. Report publication success only from the returned `publication` object.

Read [references/listing-contract.md](references/listing-contract.md) before creating listings with variations or a listing video. Read [references/setup.md](references/setup.md) for authentication and client configuration.

## Tool boundaries

- `get_account`: credits and scopes for the current key.
- `list_shops`: active Etsy and Shopify destinations owned by the account.
- `list_listings`: recent product-listing references; never Video Ads jobs.
- `get_listing`: safe listing result with copy, variations, referenced bucket assets, progress, validation and publication state.
- `create_listing`: asynchronous copy/image/variation/listing-video generation only.
- `publish_listing`: separate Etsy or Shopify draft/live publication of a ready listing.

## Guardrails

- Creation is billable. Publication is externally visible and must be a separate explicit user decision.
- Default to `draft` when the user requests provider creation but does not clearly request a live listing.
- For Etsy, require a valid final `etsy_taxonomy_id`; never invent one.
- Use only shop IDs returned by `list_shops` for the same provider.
- Never submit a second create call while the referenced listing is queued or running.
- Never expose API keys, OAuth tokens, filesystem paths, provider payloads, or internal errors.
- Treat `CATEGORY_MISMATCH` and refunded images as publication blockers requiring review.

From ruota/open-sinapseed, MIT.

More from ruota/open-sinapseed