{"uid":"cap_37Mvj3sPi-OuJ8rcvsaxl","slug":"mekler-ai-feed-record-mapping-inspector-208d0ff9","name":"Mekler AI Feed Record Mapping Inspector","description":"Inspect a public RSS, Atom or JSON feed and return a verified record mapping, normalized preview, ID provenance, duplicate evidence and field coverage. One uncompressed UTF-8 document up to 256 KiB; maximum 100 returned records. No pagination, complete history, JavaScript rendering or safe-link guarantee.","url":"https://api.mekler.ai/v1/data/feeds/inspect-record-mapping?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"type":"string","maxLength":2048},"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,64}$"},"max_records":{"type":"integer","default":20,"maximum":100,"minimum":1},"records_path":{"type":["string","null"],"maxLength":128}}},"responseSchema":{"type":"json","example":{"format":"rss","status":"ok","mapping":{"id":"guid","url":"link","title":"title","published":"pubDate"},"records":[{"id":"mekler-example-1","url":"https://mekler.ai/","title":"Mekler feed example","id_basis":"source_id","published":"Tue, 20 Oct 2026 00:00:00 GMT"}],"coverage":{"truncated":false,"field_counts":{"id":1,"url":1,"title":1,"published":1},"source_records":1,"returned_records":1,"source_id_records":1,"duplicate_ids_in_returned":0},"source_url":"https://www.nasa.gov/feed/","limitations":["One uncompressed UTF-8 RSS 2.0, Atom 1.0 or JSON document up to 256 KiB; previews also stop at 40000 serialized UTF-8 bytes. No JavaScript, authentication, pagination or complete-history claim.","JSON mapping chooses the first recognized field in documented precedence; inspect mapping and field_counts. Optional records_path is a JSON Pointer to the record array.","Source IDs are retained; URL hashes are stable while URLs persist; content hashes change when content changes. Duplicates remain visible.","Dates are source strings, not verified event times. Links are normalized but not fetched or proven safe. Descriptions, markup and enclosures are not included."],"observed_at":"2026-10-20T00:00:00Z","records_path":"/rss/channel/item"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rxsy-xuj6-NY9QW-6fp1U","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a public RSS, Atom, or JSON feed URL and returns a normalized record mapping, field coverage stats, duplicate evidence, and ID provenance for up to 100 records.","exampleAgentPrompt":"Inspect the NASA news feed at https://www.nasa.gov/feed/ and return up to 30 records — show me the field mapping, how many records have source IDs, and whether there are any duplicate IDs.","exampleUseCases":[{"title":"Audit podcast feed data quality","prompt":"Can you inspect the RSS feed at https://feeds.simplecast.com/example-podcast and return up to 50 records? I want to see the field mapping, field coverage counts, and whether any episode GUIDs are duplicated."},{"title":"Preview a JSON news feed before ingestion","prompt":"Check the JSON feed at https://example-news.com/feed.json and show me up to 20 normalized records — I need to know which fields map to ID, URL, title, and published date, and whether any records are missing those fields."},{"title":"Verify Atom feed structure for a content pipeline","prompt":"Inspect this Atom feed at https://blog.example.org/atom.xml — return the field mapping and coverage stats for up to 100 entries so I can confirm it has consistent IDs and publication dates before I start pulling from it."}],"resultDescription":"A JSON object containing the detected feed format, a field mapping showing which source fields correspond to standard fields (id, url, title, published), up to 100 normalized record previews each with ID basis, field coverage counts (total source records, returned records, source_id_records, duplicate_ids_in_returned), whether results were truncated, the records_path used, observed_at timestamp, source_url, and a limitations array explaining what the endpoint does not guarantee.","failureModes":["Feed URL is unreachable or returns non-2xx HTTP — status field indicates error","Feed exceeds 256 KiB uncompressed — document is rejected or truncated","Feed format not recognized as RSS 2.0, Atom 1.0, or JSON feed — parsing fails","records_path JSON Pointer does not point to a valid array in a JSON feed — mapping fails","Feed requires authentication or JavaScript rendering — not supported, returns error","max_records out of range (below 1 or above 100) — request rejected with validation error","request_id does not match required pattern — request rejected"],"whenToPreferThis":"Choose this endpoint when you need to inspect, normalize, or audit the structure of a public RSS, Atom, or JSON feed before ingesting it — especially to understand field mappings, verify ID consistency, detect duplicates, and measure field coverage. Prefer it over generic HTTP fetching when you want structured feed metadata rather than raw XML/JSON, and when feeds are under 256 KiB and publicly accessible without authentication or JavaScript.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:13:48.381Z","isFirstParty":false,"canonicalSlug":"mekler-ai-feed-record-mapping-inspector-208d0ff9"}