{"uid":"cap_ujhkBv4GwumUNCWnEWK6n","slug":"brainiac-ros-bag-telemetry-parser-2a8c8d60","name":"BRAINIAC ROS Bag Telemetry Parser","description":"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.","url":"https://www.brainiac.software/api/v1/robotics-intelligence/rosbag-telemetry-parse?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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":"string","maxLength":40},"field":{"type":"string","maxLength":120},"topic":{"type":"string","maxLength":200},"value":{"type":"number","maximum":1000000000000,"minimum":-1000000000000},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000},"schemas":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"side":{"enum":["left","right","a","b"],"type":"string"},"topic":{"type":"string","maxLength":200},"fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","maxLength":120},"type":{"type":"string","maxLength":80},"optional":{"type":"boolean"}},"additionalProperties":false},"maxItems":200},"source":{"type":"string","maxLength":200},"messageType":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":200},"downtime":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"message":{"type":"string","maxLength":400},"robotId":{"type":"string","maxLength":80},"category":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"workcellId":{"type":"string","maxLength":80},"durationSec":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":2000},"opcuaTags":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"path":{"type":"string","maxLength":300},"unit":{"type":"string","maxLength":40},"nodeId":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"dataType":{"type":"string","maxLength":80},"browseName":{"type":"string","maxLength":160},"displayName":{"type":"string","maxLength":160}},"additionalProperties":false},"maxItems":2000},"plcAlarms":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"area":{"type":"string","maxLength":120},"code":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"message":{"type":"string","maxLength":400},"severity":{"type":"string","maxLength":40},"controllerId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"protocols":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"name":{"type":"string","maxLength":120},"role":{"enum":["required","available","controller","device"],"type":"string"},"source":{"type":"string","maxLength":200},"version":{"type":"string","maxLength":80},"features":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":40}},"additionalProperties":false},"maxItems":100},"maintenance":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"robotId":{"type":"string","maxLength":80},"component":{"type":"string","maxLength":160},"cycleCount":{"type":"number","maximum":1000000000,"minimum":0},"runtimeHours":{"type":"number","maximum":1000000000,"minimum":0},"intervalHours":{"type":"number","maximum":1000000000,"minimum":0},"lastServiceAt":{"type":"string","maxLength":40},"intervalCycles":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":500}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6dBOhkyMiPzOH-drzWF0O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses ROS bag telemetry exports (topics, samples, cycles) from robotics systems and returns structured topic summaries, time-series samples, and anomaly findings.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Joint state telemetry analysis","prompt":"I have a CSV export from a ROS bag recorded on our robot arm R1 with /joint_states topic data. Can you parse it and show me the topic summaries, field counts, and all the time-series samples?"},{"title":"Multi-robot TCP force review","prompt":"Parse this JSON export from our ROS bag that includes /tcp_force readings from robots R1 and R2 during a production run on 2026-11-01 — I need a breakdown of topics, sample counts, and any findings flagged."},{"title":"Cycle and sensor data extraction","prompt":"I exported our rosbag as a CSV with both cycle records and sensor samples for robot workcell W3. Can you structure this into topics with timestamps, sample values, and units so I can feed it into our monitoring dashboard?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:51.355Z","isFirstParty":false,"canonicalSlug":"brainiac-ros-bag-telemetry-parser-2a8c8d60"}