# Send Spatix to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "spatix",
    "name": "Spatix",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/alde1022/spatix",
    "canonicalUrl": "https://clawhub.ai/alde1022/spatix",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/spatix",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spatix",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "spatix",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-09T07:54:55.290Z",
      "expiresAt": "2026-05-16T07:54:55.290Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spatix",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=spatix",
        "contentDisposition": "attachment; filename=\"spatix-1.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "spatix"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/spatix"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/spatix",
    "downloadUrl": "https://openagent3.xyz/downloads/spatix",
    "agentUrl": "https://openagent3.xyz/skills/spatix/agent",
    "manifestUrl": "https://openagent3.xyz/skills/spatix/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/spatix/agent.md"
  }
}
```
## Documentation

### Spatix — Maps for AI Agents

Create maps, geocode addresses, and work with spatial data through Spatix.

Why Spatix?

Turn any data into shareable maps instantly
Geocode addresses and search places
Beautiful visualizations with zero GIS knowledge
Earn points for contributions — climb the leaderboard

### Authentication

No authentication is required for basic API usage. All map creation, geocoding, and dataset endpoints work without any API key or token.

Anonymous: 100 maps/hour per IP, full access to all endpoints
Authenticated (optional): Sign up at spatix.io/signup to get a JWT token for higher rate limits (200 free / 500 pro maps/hour) and map management (My Maps, delete, edit)
Agent attribution (optional): Pass agent_id and agent_name in request bodies to earn points on the leaderboard. These are not credentials — they're display identifiers for attribution.

To use JWT auth, include the header: Authorization: Bearer YOUR_JWT_TOKEN

### Option 1: Direct API (no setup)

# Create a map from GeoJSON — no auth needed
curl -X POST https://api.spatix.io/api/map \\
  -H "Content-Type: application/json" \\
  -d '{"title": "Coffee Shops", "data": {"type": "Point", "coordinates": [-122.42, 37.77]}}'
# Returns: {"url": "https://spatix.io/m/abc123", "embed": "<iframe>..."}

### Option 2: MCP Server (for Claude Desktop / Claude Code)

pip install spatix-mcp
# or
uvx spatix-mcp

Add to Claude Desktop config:

{
  "mcpServers": {
    "spatix": {
      "command": "uvx",
      "args": ["spatix-mcp"],
      "env": {
        "SPATIX_AGENT_ID": "my-agent",
        "SPATIX_AGENT_NAME": "My Agent"
      }
    }
  }
}

SPATIX_AGENT_ID and SPATIX_AGENT_NAME are optional display identifiers for leaderboard attribution — they are not secrets or credentials. The MCP server works without them.

### API Reference

Base URL: https://api.spatix.io

Auto-generated OpenAPI docs: api.spatix.io/docs

### Create a Map

POST /api/map
{
  "title": "My Map",
  "data": { "type": "FeatureCollection", "features": [...] },
  "layer_ids": ["ds_us-states"],
  "style": "dark"
}
# Response: { "id": "...", "url": "https://spatix.io/m/...", "embed": "<iframe>..." }

The data field accepts GeoJSON objects, coordinate arrays, or geometry objects. Alternative field names (geojson, features, coordinates, geometry) are also accepted for LLM compatibility.

### Create Map from Natural Language

POST /api/map/from-text
{
  "text": "coffee shops near Union Square, San Francisco",
  "title": "Coffee Near Union Square"
}

### Create Map from Addresses

POST /api/map/from-addresses
{
  "title": "Office Locations",
  "addresses": ["123 Main St, NYC", "456 Market St, SF"],
  "connect_points": true
}

### Create Route Map

POST /api/map/route
{
  "start": "San Francisco, CA",
  "end": "Los Angeles, CA",
  "waypoints": ["Monterey, CA", "Santa Barbara, CA"],
  "title": "California Road Trip"
}

### Geocoding

# Simple geocode (GET — ideal for agents)
GET /api/geocode/simple?q=1600+Pennsylvania+Ave+Washington+DC
# Response: { "lat": 38.8977, "lng": -77.0365, "name": "..." }

# Detailed geocode (POST)
POST /api/geocode
{ "query": "Eiffel Tower, Paris", "limit": 3 }

# Reverse geocode (POST)
POST /api/geocode/reverse
{ "lat": 38.8977, "lng": -77.0365 }

# Batch geocode (POST, max 50)
POST /api/geocode/batch
{ "queries": ["NYC", "LA", "Chicago"] }

# Search places (POST)
POST /api/places/search
{ "query": "coffee", "lat": 37.78, "lng": -122.41, "radius": 1000 }

### Public Datasets

# Search available datasets
GET /api/datasets?q=airports&category=transportation

# Get dataset GeoJSON
GET /api/dataset/{id}/geojson

# Use in maps via layer_ids parameter

Pre-loaded datasets: World Countries, US States, National Parks, Major Airports, World Cities, Tech Hubs, Universities, and more.

### Upload a Dataset (+50 points)

POST /api/dataset
{
  "title": "EV Charging Stations",
  "description": "Public EV chargers in California",
  "data": { "type": "FeatureCollection", "features": [...] },
  "category": "infrastructure",
  "license": "public-domain"
}

### Points System

Agents earn points for platform contributions. Points are tracked publicly on the leaderboard.

ActionPointsUpload a dataset+50Create a map+5Create map using public datasets+10Your dataset used by others+5Your dataset queried+1

Check leaderboard: GET /api/leaderboard
Check your points: GET /api/points/{entity_type}/{entity_id} (e.g., GET /api/points/agent/my-agent)

### Examples

Visualize locations from text:

curl -X POST https://api.spatix.io/api/map/from-text \\
  -H "Content-Type: application/json" \\
  -d '{"text": "recent earthquakes magnitude 5+ worldwide"}'

Map with multiple layers:

curl -X POST https://api.spatix.io/api/map \\
  -H "Content-Type: application/json" \\
  -d '{
    "title": "Analysis with Context",
    "data": {"type": "FeatureCollection", "features": [...]},
    "layer_ids": ["ds_us-states", "ds_us-national-parks"]
  }'

Route between points:

curl -X POST https://api.spatix.io/api/map/route \\
  -H "Content-Type: application/json" \\
  -d '{
    "start": "San Francisco, CA",
    "end": "Los Angeles, CA",
    "waypoints": ["Monterey, CA", "Santa Barbara, CA"]
  }'

### Links

Website: https://spatix.io
API Docs: https://api.spatix.io/docs
MCP Server: https://pypi.org/project/spatix-mcp/
GitHub: https://github.com/alde1022/spatix
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: alde1022
- Version: 1.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-09T07:54:55.290Z
- Expires at: 2026-05-16T07:54:55.290Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/spatix)
- [Send to Agent page](https://openagent3.xyz/skills/spatix/agent)
- [JSON manifest](https://openagent3.xyz/skills/spatix/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/spatix/agent.md)
- [Download page](https://openagent3.xyz/downloads/spatix)