Claim merchant skill

Skill alphaparkinc/claim-merchant-skill

GenPark skill: Run pay-per-acquisition social drops, Plaid card-linked verification, and Venmo rewards payouts using Claim Merchants.

Install

npx -y skills add alphaparkinc/claim-merchant-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
9 stars9 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Modular agentic loyalty & rewards skill for Claim Merchants integration. Automates customer acquisition drops, retention offers, Plaid card-linked tracking, and analytics.

SKILL.md

5.3 KB, as published. Nobody here has run it

Claim Merchants Social Rewards Skill

Overview

Claim is a social commerce and rewards operating system (acquired by Grubhub's parent company, Wonder) that enables local and online merchants (especially restaurants and retailers) to run risk-free, pay-per-acquisition marketing drops. This skill enables GenPark AI agents to construct, manage, and analyze Claim campaigns, matching high-intent customers with products/venues using transactional card-linked mechanics.

sequenceDiagram
    autonumber
    actor Customer
    participant App as Claim Consumer App
    participant Plaid as Plaid API
    participant Merchant as Claim Merchant OS
    participant Venmo as Venmo API

    Customer->>App: Link debit/credit card via Plaid
    Merchant->>Merchant: Create "Thursday Drop" offer ($5 cash back)
    App->>Customer: Delivers offer to user's wallet
    Customer->>Merchant: Swipes physical credit card at check-out
    Plaid->>Merchant: POST /v1/merchant/webhooks/transaction (Matches linked card swipe)
    Merchant->>Venmo: POST /v1/payouts (Trigger cashback payment)
    Venmo-->>Customer: $5 cash back deposited to customer Venmo

Core Capabilities

1. Pay-Per-Acquisition Drops (New Customers)

Weekly Custom Drops: Launch targeted cashback campaigns that "drop" in customer wallets every Thursday.
Zero Upfront Costs: Merchants pay purely on performance. A fee is only collected when an offer is successfully claimed and a transaction is completed.
Social Amplification: Users can trade or gift rewards with their friends in the app, naturally extending brand reach via viral word-of-mouth discovery.

2. Card-Linked POS Redemption (Frictionless Operations)

Zero Operational Friction: No coupons, promo codes, staff training, or custom QR-code POS integrations required. Purchases are auto-verified in the background.
Plaid Financial Integrations: Leverages Plaid to securely monitor transaction streams for linked credit/debit card activity at merchant locations.

3. Customer Retention & Repeat Visits

Regulars Nudging: Automatically trigger follow-up retention rewards when a first-time customer completes a dining/shopping "Claim" offer to convert them into standard regulars.
Cohort Segmentation: Identify and segment first-time diners/shoppers from repeat regulars to adjust incentive scaling.

4. Performance & Competitor Benchmarking

First-Party Insights: Track detailed customer demographics, purchase baskets, lifetime value (LTV), and frequency.
Competitor Indexing: Gain real-time, aggregated data on how your establishment ranks against similar local competitors in market share and repeat loyalty.

API Reference & Payloads

1. Launch a Rewards Offer Campaign

POST https://api.claim.co/v1/merchant/campaigns

Request Headers:

Authorization: Bearer <your_claim_merchant_token>
Content-Type: application/json

Request Payload:

{
  "name": "Thursday Diner Drop - May 2026",
  "campaign_type": "ACQUISITION_DROP",
  "cashback_amount": 5.00,
  "start_date": "2026-05-21T00:00:00Z",
  "end_date": "2026-05-28T23:59:59Z",
  "target_criteria": {
    "geographic_radius_miles": 5.0,
    "competitor_categories": ["casual_dining", "coffee_shops"]
  },
  "max_budget": 500.00
}

Response Payload:

{
  "campaign_id": "camp_88910243",
  "status": "SCHEDULED",
  "cashback_amount": 5.00,
  "targeted_users_estimate": 4500,
  "created_at": "2026-05-18T18:56:00Z"
}

2. Webhook: Card-Linked Transaction Matched

POST https://api.claim.co/v1/merchant/webhooks/transaction

Request Payload (Sent by Plaid/Claim to Merchant):

{
  "event_id": "evt_9981240a2",
  "event_type": "transaction.matched",
  "timestamp": "2026-05-18T18:56:46Z",
  "data": {
    "merchant_id": "merch_770123",
    "customer_id": "cust_44901",
    "campaign_id": "camp_88910243",
    "transaction": {
      "amount": 24.50,
      "currency": "USD",
      "timestamp": "2026-05-18T18:55:00Z",
      "masked_card_last_four": "1024"
    }
  }
}