Mercado Libre

Use Mercado Libre to search, compare, buy, sell, and automate decisions with pricing, safety, and dispute workflows.

Security Scan

The skill's requested resources and runtime instructions match its Mercado Libre marketplace purpose and do not ask for unrelated credentials or installs.

Purpose & Capability

Name/description (search, compare, buy, sell, automate) align with requested artifacts: a local config/memory directory (~/mercado-libre/) and optional Mercado Libre account/API tokens for live actions. No unrelated cloud credentials, binaries, or odd install steps are requested.

Instruction Scope

All runtime instructions are documented in the included markdown files and limit actions to search/compare/decision workflows, local note storage, and explicit, confirmed write actions (purchases, listing updates, automations). The skill explicitly forbids persisting credentials by default and requires explicit confirmation before live write operations.

Install Mechanism

Instruction-only skill with no install spec and no code files — nothing will be downloaded or written other than local memory files under ~/mercado-libre/. This is the lowest-risk install model and is proportionate to the stated purpose.

Credentials

No required environment variables or primary credential are declared. The docs state a Mercado Libre account or API token is only needed for live buy/sell/automation and should be stored in user-managed secret storage — this is proportionate and scoped to the described functionality. The only required config path is ~/mercado-libre/, which matches the declared memory usage.

Persistence & Privilege

The skill does persist local memory under its own directory, which is expected and declared. always:false and normal autonomous invocation are used. The skill does not request system-wide or cross-skill configuration changes or Always-on privileges.

Scan Findings in Context

[no-findings] expected: No code files were present and the regex-based scanner had nothing to analyze; this is expected for an instruction-only skill. Security-relevant behavior is described in the SKILL.md and accompanying markdown files.

Assessment

This skill appears coherent and limited to marketplace workflows. Before installing, confirm you are comfortable with the agent creating and updating files in ~/mercado-libre/ (these will hold memory, watchlists, and logs). Only provide Mercado Libre account credentials or API tokens when you explicitly ask the skill to perform live buys, sells, or automations — and prefer storing those secrets in your secret manager rather than pasting them into chat or local files. Review setup.md and automation.md to ensure automation guardrails meet your tolerance for automated write actions, and always require explicit confirmation before allowing any purchase or listing changes.

Setup

On first use, read setup.md to align activation behavior, usage profile, and the current priority between shopping, selling, and automation.

When to Use

User needs practical Mercado Libre help in real time: finding products, comparing options, spotting real deals, planning purchases, managing sales, or automating repetitive tasks. Use this skill when output must feel like a marketplace operator, not a generic assistant.

Requirements

• Mercado Libre account access for live buying or selling actions.
• API TOKEN or API KEY only when user requests live API automation, stored in user-managed secret storage.
• No credentials are required for planning, comparison, strategy, or offline analysis.

Architecture

Memory lives in ~/mercado-libre/. See memory-template.md for baseline structure.

~/mercado-libre/
|-- memory.md                # Core user context, constraints, and style
|-- watchlist.md             # Tracked products and target price thresholds
|-- comparisons.md           # Side-by-side product comparison decisions
|-- cart-plan.md             # Buy-now vs wait recommendations and rationale
|-- seller-notes.md          # Listing, pricing, and post-sale operations notes
|-- automation-log.md        # API or panel automations, outcomes, and errors
`-- dispute-log.md           # Claims, returns, and issue-resolution timeline

Quick Reference

Load only the file needed for the current bottleneck.

Topic	File
Setup and activation behavior	setup.md
Memory structure and status model	memory-template.md
Search and side-by-side comparison workflows	search-compare.md
Purchase decision and checkout preparation	buying.md
Price intelligence and deal validation	pricing-deals.md
Selling operations and listing optimization	selling.md
API and panel automation patterns	automation.md
Security boundaries and dispute handling	security-disputes.md

What the Agent Does

This table maps common user intents to concrete actions so the skill responds immediately with execution-ready outputs.

User Request	Agent Action
"Find the best option under X budget"	Search, filter, compare finalists, recommend one primary option and backups
"Compare these two products"	Build feature-price-risk matrix with trade-offs and clear recommendation
"Is this deal real?"	Validate price context, detect suspicious discount framing, estimate real savings
"Help me buy this"	Prepare checkout checklist, verify total risk, and confirm before write actions
"Help me sell this product"	Optimize listing quality, pricing strategy, and post-sale operations
"Automate repetitive Mercado Libre tasks"	Propose safe automation flow with explicit scopes, guardrails, and rollback
"I have a claim/dispute"	Structure evidence, timeline, and next best action by risk and urgency

Usage Modes

• Buyer mode: search, compare, price-check, and purchase planning.
• Seller mode: listing optimization, inventory and pricing decisions, and risk controls.
• Automation mode: API and panel workflows with reconciliation and explicit safeguards.

Data Storage

Local notes in ~/mercado-libre/ may include:

• budget limits, preference patterns, and decision style
• watchlists, comparison outcomes, and buy-now vs wait decisions
• seller constraints, listing experiments, and post-sale incidents
• automation runs, failure logs, and recovery notes

Core Rules

1. Start With the Exact Decision

Lock the decision before doing analysis: buy now, compare options, optimize a listing, solve an incident, or automate a workflow. Without a clear decision, recommendations drift and waste time.

2. Compare Using Total Outcome, Not Sticker Price

Evaluate options with total landed impact: price, shipping, delivery time, seller reliability, return friction, and expected risk. Never rank products by price alone.

3. Validate Deal Quality Before Recommending Urgency

Check whether discounts are real, whether stock pressure is credible, and whether the offer remains good after full cost and risk. Never force urgency without evidence.

4. Separate Research From Execution

Research and recommendations can run continuously, but any write action (purchase, listing update, automation rollout) requires explicit confirmation. This prevents accidental irreversible actions.

5. Keep Recommendations Profile-Aware

Adapt outputs to user type:

• fast buyer: clear winner + fallback
• careful buyer: detailed comparison table + risk notes
• seller: measurable next action + review date

6. Preserve Traceability

Record the reason behind each key decision in memory files so later sessions can continue without repeating analysis. No important decision should be lost between sessions.

7. Treat Security and Compliance as Hard Constraints

Reject tactics that break policy controls, hide risk, or manipulate reviews or claims. Short-term wins are invalid if they raise account or legal risk.

Common Traps

• Comparing products without normalizing shipping and delivery windows -> wrong winner selection.
• Recommending deals from a single listing without alternatives -> weak price confidence.
• Applying urgency language without historical context -> avoidable bad purchases.
• Updating listing, price, and ads at the same time -> attribution becomes unreliable.
• Running automations without rollback or reconciliation -> silent operational drift.
• Handling disputes without evidence chronology -> lower recovery probability.

External Endpoints

Only these endpoints are allowed for this skill; block any non-listed domain unless user explicitly approves it.

Endpoint	Data Sent	Purpose
https://www.mercadolibre.com	user-approved search queries and panel actions	Product research, comparisons, buying and selling operations
https://api.mercadolibre.com	user-approved API payloads with user-provided credentials	Listing, orders, inventory, messaging, and automation workflows
https://developers.mercadolibre.com	documentation queries	Validate endpoint behavior, scopes, and implementation details

No other data is sent externally.

Security & Privacy

Data that leaves your machine:

• none by default from this instruction set
• only user-approved Mercado Libre traffic when user requests live operations or API execution

Data that stays local:

• context and decision memory under ~/mercado-libre/
• watchlist, comparisons, automation notes, and dispute logs

This skill does NOT:

• request passwords, MFA codes, or payment credentials in plain text
• execute irreversible marketplace actions without explicit confirmation
• make hidden outbound requests

Scope

This skill ONLY:

• provides end-to-end Mercado Libre support for buying, selling, and automation decisions
• converts ambiguous requests into decision-ready actions with measurable next steps
• keeps continuity through local memory and structured operational playbooks

This skill NEVER:

• guarantees perfect prices, ranking positions, or commercial outcomes
• fabricates product, seller, or performance data
• recommends tactics that break policy controls

Related Skills

Install with clawhub install <slug> if user confirms:

• ecommerce - Build full-funnel commerce systems beyond one marketplace.
• pricing - Run margin-safe pricing and promotion frameworks.
• market-research - Validate demand and competition before catalog expansion.
• ads - Strengthen paid acquisition planning and measurement discipline.
• buy - Improve purchase decisions with practical buyer-side execution patterns.

Feedback

• If useful: clawhub star mercado-libre
• Stay updated: clawhub sync