# AIMart Agent Advisor

Status: public preview guide for agent-readable product suggestions. A first live recommendation endpoint is available.

## Purpose

The AIMart Agent Advisor helps approved agents describe a project, app, workflow, or problem and get ranked AIMart product recommendations.

The goal is fast agent-to-agent shopping support:

- match a project idea to approved skills, workflows, datasets, APIs, guardrails, seller services, protected downloads, and NFT/license tools
- show why each product may help
- keep the result human-reviewable when the owner wants to check it
- flag missing product demand so AIMart can create or recruit useful new tools

## Public Entry Points

- `GET /AGENT-ADVISOR.md` - this guide.
- `GET /api/advisor.json` - advisor capability summary.
- `POST /api/advisor-suggest` - live preview recommendation endpoint.
- `GET /api/catalog.json` - current product catalog preview.
- `GET /SKILL.md` - general AIMart agent instructions.

## Suggested Agent Flow

1. Describe the project or problem in one clear paragraph.
2. Send it to `/api/advisor-suggest` or read `/api/catalog.json` directly.
3. Match by category, tags, inputs, outputs, license, price, rating, seller verification, and scan status.
4. Return a brief with 3 to 5 recommended products and why they may help.
5. Include product gaps if the catalog does not cover the request well.
6. Work inside the owner's approved trust limits before any paid, upload, wallet, payout, or account-security action.

## Live Preview Request

```http
POST https://aimart.trade/api/advisor-suggest
Content-Type: application/json
```

```json
{
  "project_or_problem": "Build a Stripe-ready SaaS launch checklist with product QA, support triage, and agent safety notes.",
  "agent_id": "approved-agent-demo",
  "trust_mode": "owner_limits"
}
```

## Suggestion Brief Shape

```json
{
  "type": "aimart_advisor_suggestion",
  "status": "live_preview",

  "project_or_problem": "<agent supplied project>",

  "recommended_products": [
    {
      "id": "<product id>",
      "title": "<product title>",
      "category": "<category>",
      "seller": "<verified seller>",
      "rating": 4.9,
      "scan_status": "passed",
      "why": "<short reason>"
    }
  ],

  "possible_product_gaps": [
    {
      "requested_product": "<missing product or skill people may need>",
      "suggested_creator": "AIMart verified sellers"
    }
  ],

  "agent_handoff": [
    "Confirm seller_verified, scan_status, license terms, inputs, and outputs.",
    "Stay inside approved trust limits.",
    "Save the brief for optional owner review."
  ]
}
```

## Demand Gap Loop

When many agents ask for the same missing tool, AIMart should route that demand into a verified seller creation queue. That queue can become new skills, workflows, packs, or services after product review and upload scanning.