# BRAINIAC ROS Bag Telemetry Parser

> BRAINIAC ROS Bag Telemetry Parser is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-12).

Parses ROS bag telemetry exports (topics, samples, cycles) from robotics systems and returns structured topic summaries, time-series samples, and anomaly findings.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/robotics-intelligence/rosbag-telemetry-parse?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-ros-bag-telemetry-parser-2a8c8d60
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ujhkBv4GwumUNCWnEWK6n

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brainiac-ros-bag-telemetry-parser-2a8c8d60 -d '<json body>'
```

Example prompt: Parse this ROS bag telemetry export from robot R1 — I have a CSV with /joint_states and /tcp_force topics recorded on 2026-11-01 — and give me structured topic summaries and sample breakdowns.

## When to prefer this

Use this endpoint when you have a ROS bag telemetry export (CSV, JSON, or plain text) from a robotic system and need it parsed into structured topic summaries and time-series samples without setting up local ROS infrastructure. Ideal for agents doing post-hoc telemetry analysis, robot health monitoring, or feeding structured sensor data into downstream pipelines. Not suitable for live robot connections, binary .bag decoding, or issuing machine commands.

## Known failure modes

- Binary .bag/.mcap files not decoded — must supply CSV/JSON topic exports
- Missing values not invented — sparse data returns fewer samples
- Input exceeds maxLength limits (200,000 chars for CSV/JSON text, 12MB for base64 file)
- Malformed timestamps or non-numeric values in sample rows cause those rows to be skipped
- More than 5,000 samples or 2,000 cycles truncated to schema limits

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with status, an array of topic summaries (topic name, firstAt, lastAt, robotIds, fieldCount, sampleCount), an array of structured samples (timestamp, id, field, topic, value, unit, robotId, source), findings list, checkedAt timestamp, topicCount, sampleCount, and a limitations array clarifying what was and was not performed (no live equipment connection, no machine commands issued).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "cycles": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "endedAt": {
      "type": "string",
      "maxLength": 40
     },
     "program": {
      "type": "string",
      "maxLength": 160
     },
     "robotId": {
      "type": "string",
      "maxLength": 80
     },
     "startedAt": {
      "type": "string",
      "maxLength": 40
     },
     "workcellId": {
      "type": "string",
      "maxLength": 80
     },
     "durationSec": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 2000
  },
  "samples": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "unit": {
      "type": "
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "parsed",
  "topics": [
   {
    "topic": "/joint_states",
    "lastAt": "2026-11-01T10:00:01.000Z",
    "firstAt": "2026-11-01T10:00:00.000Z",
    "robotIds": [
     "R1"
    ],
    "fieldCount": 1,
    "sampleCount": 2
   },
   {
    "topic": "/tcp_force",
    "lastAt": "2026-11-01T10:00:00.000Z",
    "firstAt": "2026-11-01T10:00:00.000Z",
    "robotIds": [
     "R1"
    ],
    "fieldCount": 1,
    "sampleCount": 1
   }
  ],
  "samples": [
   {
    "at": "2026-11-01T10:00:00.000Z",
    "id": "S1",
    "unit": "rad",
    "field": "position[0]",
    "topic": "/joint_states",
    "value": 0.12,
    "source": "Caller-supplied bag export",
    "robotId": "R1",
    "valueSupplied": true
   },
   {
    "at": "2026-11-01T10:00:01.000Z",
    "id": "S2",
    "unit": "rad",
    "field": "position[0]",
    "topic": "/joint_states",
    "value": 0.13,
    "source": "Caller-supplied bag export",
    "robotId": "R1",
    "valueSupplied": true
   },
   {
    "at": "2026-11-01T10:00:00.000Z",
    "id": "S3",
    "unit": "N",
    "field": "force_z",
    "topic": "/tcp_force",
    "value": 12,
    "source": "Caller-supplied bag export",
    "robotId": "R1",
    "valueSupplied": true
   }
  ],
  "findings": [],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "topicCount": 2,
  "limitations": [
   "ROS bag topic samples, schemas, cycles, downtime, OPC UA tags, PLC alarms, maintenance records, and protocol declarations are copied only from labeled fields or text/CSV/JSON exports supplied by the caller.",
   "No live industrial equipment connection is opened and no machine commands are issued.",
   "Binary .bag/.mcap files are not fully decoded here. Supply topic CSV/JSON exports or labeled sample rows. Missing values are not invented.",
   "Anomaly, cycle-time, downtime, and maintenance estimates use only supplied measurements and intervals.",
   "Protocol compatibility compares caller-supplied required versus available protocol names, versions, and features only. Protocol specifications are not invented."
  ],
  "sampleCount": 3,
  "apiKeyRequired": false,
  "paidProviderUsed": false,
  "machineCommandsIssued": false,
  "liveEquipmentConnected": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-ros-bag-telemetry-parser-2a8c8d60/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
