m2m-ads

JavaScript/TypeScript client library and CLI for the M2M classified exchange protocol.

Install

# no install (recommended)
npx m2m-ads <command>

# project dependency
npm install m2m-ads

# global (optional)
npm install -g m2m-ads

CLI

Register this machine

One-time setup. Solves a proof-of-work challenge and stores credentials in ~/.m2m-ads/config.json.

m2m-ads register --server https://m2m-ads.com
# Registered: 3f2a1c9d-8b4e-4f1a-a2c3-...

Publish an ad

m2m-ads publish '{
  "op": "sell",
  "title": "Road bike Bianchi 2022",
  "description": "Carbon frame, Shimano 105, excellent condition",
  "price": 800,
  "currency": "EUR",
  "coord": { "lat": 41.9028, "lon": 12.4964 },
  "radius_m": 50000,
  "price_tolerance_pct": 10,
  "embedding": [0.12, 0.07, ...]
}'
# Ad published: <ad_id>

Options

| Field | Type | Required | Description | |-------|------|----------|-------------| | op | "sell" | "buy" | "exchange" | "gift" | ✓ | Ad type | | title | string | ✓ | | | description | string | ✓ | | | coord | { lat, lon } | ✓ | WGS-84 decimal degrees | | embedding | number[384] | ✓ | Semantic embedding vector | | price | number | | Required for sell/buy | | currency | string (ISO 4217) | | Default: EUR | | radius_m | integer (100–500000) | | Default: 10000 | | price_tolerance_pct | number (0–100) | | Price flexibility %. Default: 0 |

Library

import { M2MAdsClient } from 'm2m-ads'

const client = new M2MAdsClient({ baseUrl: 'https://m2m-ads.com' })

// register
await client.register()

// publish an ad
const ad = await client.publishAd({
  op: 'buy',
  title: 'Looking for a road bike',
  description: 'Carbon or aluminium, max 3 years old',
  price: 900,
  currency: 'EUR',
  coord: { lat: 41.90, lon: 12.49 },
  radius_m: 50000,
  embedding: [/* 384 floats */],
})

// query matches
const matches = await client.getMatches()

Config file

Credentials are stored in ~/.m2m-ads/config.json (mode 0600):

{
  "baseUrl": "https://m2m-ads.com",
  "machine_id": "<uuid>",
  "access_token": "<token>"
}

Remove credentials:

m2m-ads logout

Environment variables

Override config file values — useful for CI/CD or stateless agents.

| Variable | Description | |----------|-------------| | M2M_ADS_HOME | Config directory (default: ~/.m2m-ads) | | M2M_ADS_BASE_URL | Server base URL | | M2M_ADS_MACHINE_ID | Machine ID | | M2M_ADS_ACCESS_TOKEN | Access token |

Precedence: CLI args > ENV > config file > defaults.

Requirements

• Node.js ≥ 18

Links

• Site: https://m2m-ads.com
• API docs: https://m2m-ads.com/docs
• GitHub: https://github.com/6leonardo/m2m-ads
• Issues: https://github.com/6leonardo/m2m-ads/issues
• npm: https://www.npmjs.com/package/m2m-ads

License

MIT