Meta Catalog Feed Checker Skill

See every problem that would stop your products uploading to Facebook and Instagram, and fix the formatting ones in one command.

Meta Catalog Feed Checker Skill cover

What it does

Check a Facebook / Instagram (Meta) catalog product feed before you upload it to Commerce Manager: what will stop items uploading, what Meta will ignore, and what weakens your Advantage+ catalog ads and shop, in plain words. Then write a format-fixed copy with every change logged.

python3 -m metafeed check products.csv
python3 -m metafeed check products.csv --fix products.fixed.csv --currency USD   # safe fixes + products.fixed.changes.csv
python3 -m metafeed check feed.xml --issues issues.csv --json                      # RSS/Atom XML, CSV of issues, JSON for scripts

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 5 tests OK on Python 3.13 and 3.10.

Real terminal output from Meta Catalog Feed Checker Skill: demo and passing tests

What it checks (Meta's catalog field reference, updated Nov 2, 2026)

  • Upload blockers: the 8 required fields (id, title, description, availability, condition, price, link, image_link), at least one of brand / gtin / mpn, and price format (9.99 USD: number, space, ISO 4217 code, no symbols).
  • Repeated ids: Meta ignores *every* instance of a repeated id, so both products disappear.
  • Values: availability (in stock, out of stock), condition, gender, age_group, status; Google Merchant Center values like in_stock or preorder that Meta's product feed doesn't use.
  • Content: length limits (title 200, 65 recommended; description 9999), HTML, capitals or links in descriptions, description same as title, hex colours, "Size L", "US10".
  • Links and images: http(s) URLs, product links that point to Facebook or Instagram instead of your site, non-JPEG/PNG images, more than 50 additional images.
  • Identifiers, sales and variants: GTIN length and check digit, ISBN-10, sale_price below price in the same currency, sale date format, item groups whose variants don't differ, core attributes misused in additional_variant_attribute.
  • Other fields: shipping (US:NY:Ground:9.99 USD), shipping_weight, internal_label (['summer','trending']), custom_number range, native_commerce values, quantity, legacy names (visibility, inventory, product_tags).

Safe fixes

--fix writes a new file (never your original) and only changes formats it can be sure of: Meta's supported values, price format (with --currency for bare numbers), GTIN dashes and spaces, "Size " prefixes. It never invents GTINs, brands or ids. Each change goes in <out>.changes.csv.

Agent skill

Copy skills/meta-catalog-feed into your agent's skills folder (Claude Code: .claude/skills/), or install the folder as a plugin. Ask "check my Facebook catalog feed".

Run ./demo.sh for a sample feed and ./run_tests.sh for the tests. Python 3.9+, no dependencies, works offline.

Honest limits

It checks the feed file, not the images themselves, your product pages or Meta's policy review, and the India and WhatsApp-specific fields aren't covered. A clean report doesn't guarantee approval. Also selling on Google? See the Google Merchant Center Feed Checker Skill.

Format and license

Zip, 18 KB, v1.0, 15 files. You may use and modify this kit for your own work and for clients you serve, including paid client work. Not affiliated with or endorsed by Meta.

FAQ

Does it connect to my Meta account?
No, it checks the feed file on your computer.
Can I use my Google Merchant Center feed?
Yes, it reads g: XML and flags the values Meta wants written differently.
Will a clean report guarantee approval?
No, Meta also reviews images, pages and policies; this catches the feed-file problems first.
How do I get the files?
Right after payment, Stripe’s confirmation page shows your download link.
Refunds?
Email hello@youraitools.co within 14 days if it doesn’t work and we can’t fix it.
Can I pay with crypto?
Yes. Pay the same price in USDC or USDT on Base, Ethereum, Arbitrum, Optimism, Polygon or Solana from the "Pay with crypto" button, with no account or KYC. We check the payment on-chain and show your download links as soon as it confirms.

Get Meta Catalog Feed Checker Skill

Check a Facebook/Instagram catalog feed against Meta's field reference: upload blockers, duplicate ids, prices, images, variants, with a fixed copy. $19.

Save with a bundle

Pairs well with

Download$49

SEO Analytics Tools Bundle

Four SEO tools for your own data: Googlebot log analysis, keyword cannibalization, content decay and an SEO audit MCP server. $49 once ($96 separately).

View SEO Analytics Tools Bundle
DownloadFree

CSV Data Quality Checker

Free CSV validator and data quality checker: fix list with row numbers for encoding, broken and duplicate rows, mixed types, Excel-mangled IDs, bad emails.

View CSV Data Quality Checker
Download$29

Payroll Register Reconciliation Skill

Payroll register reconciliation from CSV exports: net-pay math, prior-period changes, paid-after-termination, duplicates, register vs ACH file. $29.

View Payroll Register Reconciliation Skill

Related