AgentSkillsCN

manapool

与Manapool平台交互，买卖万智牌（MTG）产品。通过此技能，用户可以搜索卡牌、优化买家购物车、下单，以及管理卖家库存与履约流程。

SKILL.md
--- frontmatter
name: manapool
description: Interact with the Manapool platform to buy and sell Magic: The Gathering (MTG) products. Use this skill to search for cards, optimize buyer carts, place orders, and manage seller inventory and fulfillment.

Manapool API Skill

This skill allows you to interact with the Mana Pool marketplace to programmatically buy and sell Magic: The Gathering products.

Environment Setup

Ensure the following are set in the environment:

  • •MANAPOOL_API_TOKEN: Your API token.
  • •MANAPOOL_API_EMAIL: Your account email.

Domain Concepts

When searching or listing items, use the following standard codes:

Conditions

  • •NM: Near Mint
  • •LP: Lightly Played
  • •MP: Moderately Played
  • •HP: Heavily Played
  • •DMG: Damaged

Finishes

  • •NF: Non-Foil
  • •FO: Foil
  • •EF: Etched Foil

Languages

  • •Common: EN (English), JA (Japanese), FR (French), IT (Italian), DE (German)
  • •Others: ES, PT, RU, KO, CH, CS

Tooling

Most interactions are handled via the CLI script: uv run manapool.

Capabilities

1. Product Search & Information

Before buying or selling, you often need to identify the correct product or check market prices.

  • •Search Singles: uv run manapool search-singles --scryfall-ids <id>
  • •Search Sealed: uv run manapool search-sealed --tcgplayer-ids <id>
  • •Get Prices: uv run manapool prices <singles|sealed|variants>

2. Buying Cards

The buying process follows a sequence: Optimize -> Create Order -> Purchase.

  • •Step 1: Optimize Cart
    • •Command: uv run manapool optimize <cart_json_file>
    • •Finds the best combination of sellers for a list of desired items.
  • •Step 2 & 3: Order/Purchase
    • •Requires direct API calls (see references/api_docs.md).
    • •POST /buyer/orders/pending-orders (to reserve items).
    • •POST /buyer/orders/pending-orders/{id}/purchase (to finalize).

3. Seller Inventory Management

Sellers can manage listings using various industry-standard IDs.

  • •List Inventory: uv run manapool seller-inventory
    • •Use --summary for a human-readable table with market comparison.
  • •Update Inventory: uv run manapool update-price --sku <sku> --price-cents <price> --quantity <qty>
    • •Updates price and quantity using TCGPlayer SKUs.

4. Order Fulfillment

Sellers must monitor and fulfill incoming orders.

  • •Use direct API calls (see references/api_docs.md).
  • •GET /seller/orders (list orders).
  • •PUT /seller/orders/{id}/fulfillment (mark as shipped).

References

  • •Detailed API docs: ./references/api_docs.md
  • •OpenAPI spec: ./references/openapi.json