iAmAI Connector

iAmAI Connector links your WordPress / WooCommerce store to the iAmAI service (https://www.iam-ai.co.il) — an external SaaS platform that writes and applies on-page SEO and AI-readiness improvements to your catalogue, product by product, so you do not have to.

This plugin requires a paid iAmAI subscription. Installing the plugin and running the first scan is free; writing to your site starts with an active subscription. Plans and prices: https://www.iam-ai.co.il/#price

What the plugin does:

• Writes a meta title, meta description and focus keyphrase for every product, page and post — real search terms with measured Hebrew demand, not the product title rewritten.
• Image alt text, FAQ blocks, breadcrumbs and Product schema (JSON-LD) for your catalogue.
• Product page depth: an answer-first summary, a specification table, who it’s for / less suitable for, a comparison with similar products from the same store and visible questions & answers — every sentence grounded in the product’s own data, approved by the store before it shows. The Product schema is completed with the product’s visible attributes, weight and dimensions.
• Works with NO SEO plugin installed: iAmAI stores the fields itself and renders them into the page head.
• No duplicate tags when you DO run one: Yoast, Rank Math, All in One SEO, SEOPress, Slim SEO and The SEO Framework are detected and iAmAI feeds its values through that plugin’s own fields.
• Setup wizard with a real scan: where you rank on Google, which shops compete with you on the same searches, and what ChatGPT, Gemini and Claude know about your brand.
• Product screen shows what iAmAI wrote for that product and what it looked like before, without an extra page load.
• Manual-edit guard: every write is preceded by a live read of the field. If you edited it by hand, iAmAI leaves it alone.
• Monthly Hebrew articles for your blog, each waiting for your approval before it is published.
• Monthly progress report by email, and a Reports screen inside wp-admin with every month’s report and history.
• IndexNow: every title or description iAmAI writes, and every product, post or page you publish, is pushed to Bing the moment it changes — and through Bing’s index to ChatGPT’s web search. (Google does not take IndexNow; this does not affect Google.)
• Reversible: every change records its previous value; disconnecting restores what was there before.
• Product feed for AI shopping (OpenAI Agentic Commerce format): the catalogue is served at /wp-json/iamai/v1/acp-feed — published, visible, priced products only, with iAmAI’s AI-readable description, live price and stock. Discovery only, no off-site checkout. Ready to submit the day the merchant program opens for your country.
• Google Merchant Center feed: the same catalogue as an RSS 2.0 product feed at /iamai-gmc-feed.xml (off by default; switch it on under Settings › AI search channels and paste the URL into Merchant Center as a scheduled fetch). One item per simple product and per variation (grouped by item_group_id), live price, sale price and dates, availability, brand, GTIN/MPN, category path, gallery images, specifications from visible attributes, colour/size/material/gender/age group, flat or free shipping for the store’s country. Titles and descriptions iAmAI wrote are declared as AI-generated (structured_title / structured_description), next to your own text. Google fetches the feed from your site; the plugin sends nothing.
• WordPress 7.x Abilities API: iAmAI’s capabilities (store status, read/write a product’s SEO fields, monthly reports, IndexNow, snapshot and review-request status) are registered as abilities, so your own AI agent can discover and use them through the site’s MCP endpoint. Requires an administrator; inert on older WordPress.
• Snapshot & restore: a versioned copy of every product, post and page (title, body, excerpt, slug, featured image and its alt text, and every SEO-plugin, page-builder and iAmAI field) is taken when you connect, weekly after that, and before each write. The שחזור screen compares any item with its copy and restores it — SEO fields only or everything — or restores the whole site. Items you edited after the copy are skipped unless you say otherwise. The copies survive uninstall by default.
• Post-purchase review requests (off by default): a few days after a WooCommerce order is completed, the customer gets one email from your own site listing up to three products they bought, each with a button to the review form with their name and email already filled in, asking for one concrete sentence about how they used the product — the descriptive text AI shopping engines and Google’s review snippets read. At most one email per customer per 30 days, an optional single reminder, an unsubscribe link in every email, never sent to someone who already reviewed. Ratings feed the Product schema’s aggregateRating automatically.

How it works:

1. Install and activate the plugin.
2. The setup wizard connects the site. The plugin creates a WordPress Application Password and sends it to iAmAI so iAmAI can scan and update your site.
3. The wizard runs the first scan and shows what it found.
4. Activate a subscription. iAmAI then generates and applies improvements to your catalogue at a paced monthly rate, and you follow every change from the iAmAI screen inside wp-admin.

The connection is built on standard WordPress Application Passwords (available since WP 5.6). You can revoke access at any time from Users → Profile → Application Passwords, or by clicking “Disconnect” inside the plugin’s settings page.

עברית

iAmAI Connector מחבר את חנות ה-WordPress / WooCommerce שלכם לשירות iAmAI, שכותב ומחיל עבורכם את עבודת ה-SEO ואת ההתאמה לכלי AI, מוצר אחרי מוצר.

התוסף דורש מנוי iAmAI בתשלום. ההתקנה והסריקה הראשונה חינם; הכתיבה לאתר מתחילה עם מנוי פעיל.

מה התוסף עושה:

• כותב כותרת SEO, תיאור מטא וביטוי מפתח לכל מוצר, עמוד ופוסט. ביטויים אמיתיים עם ביקוש נמדד בעברית, לא הכותרת של המוצר בניסוח אחר.
• טקסט חלופי לתמונות, בלוקי שאלות ותשובות, פירורי לחם וסכמת מוצר (JSON-LD).
• העמקת עמוד מוצר: תקציר שעונה קודם, טבלת מפרט, למי זה מתאים / למי פחות, השוואה למוצרים דומים מאותה חנות ושאלות ותשובות גלויות. כל משפט מבוסס על הנתונים של המוצר עצמו, ומאושר על ידי החנות לפני שהוא מוצג. סכמת המוצר מושלמת עם המאפיינים הגלויים, המשקל והמידות של המוצר.
• עובד גם בלי שום תוסף SEO: iAmAI שומר את השדות בעצמו ומציג אותם ב-head של העמוד.
• בלי תגיות כפולות כשיש תוסף SEO: Yoast, Rank Math, All in One SEO, SEOPress, Slim SEO ו-The SEO Framework מזוהים והערכים נכתבים לשדות של התוסף עצמו.
• אשף התקנה עם סריקה אמיתית: איפה אתם בגוגל, מי מתחרה בכם על אותם חיפושים, ומה ChatGPT, Gemini ו-Claude יודעים על המותג שלכם.
• מסך המוצר מציג מה iAmAI כתב ומה היה שם לפני, בלי טעינה נוספת.
• שומר עריכות ידניות: כל כתיבה מתחילה בקריאה חיה של השדה. אם ערכתם אותו ידנית, המערכת לא נוגעת בו.
• מאמרים חודשיים בעברית לבלוג, כל אחד ממתין לאישורכם לפני פרסום.
• דוח התקדמות חודשי במייל, ומסך “דוחות” בתוך wp-admin עם כל הדוחות וההיסטוריה.
• IndexNow: כל כותרת או תיאור שהמערכת כותבת, וכל מוצר, פוסט או עמוד שאתם מפרסמים, נשלחים ל-Bing ברגע השינוי, ודרך האינדקס של Bing לחיפוש של ChatGPT. (גוגל לא משתמשת ב-IndexNow; זה לא משפיע על גוגל.)
• הפיך: כל שינוי שומר את הערך הקודם, וניתוק מחזיר את מה שהיה.
• פיד מוצרים לקניות ב-AI (פורמט Agentic Commerce של OpenAI): הקטלוג מוגש ב-/wp-json/iamai/v1/acp-feed, רק מוצרים מפורסמים וגלויים עם מחיר, עם התיאור הקריא ל-AI של iAmAI ומחיר ומלאי חיים. גילוי בלבד, בלי תשלום מחוץ לאתר. מוכן להגשה ביום שתוכנית הסוחרים נפתחת בישראל.
• פיד ל-Google Merchant Center: אותו קטלוג כפיד מוצרים RSS 2.0 בכתובת /iamai-gmc-feed.xml (כבוי כברירת מחדל; מפעילים בהגדרות › ערוצי חיפוש AI ומדביקים את הכתובת ב-Merchant Center כ-URL מתוזמן). פריט לכל מוצר פשוט ולכל וריאציה (מקובצות לפי item_group_id), מחיר חי, מחיר מבצע ותאריכים, זמינות, מותג, GTIN/MPN, נתיב קטגוריה, תמונות גלריה, מפרט מהמאפיינים הגלויים, צבע/מידה/חומר/מגדר/קבוצת גיל, ומשלוח קבוע או חינם למדינת החנות. כותרת ותיאור שהמערכת כתבה מסומנים לגוגל כתוכן AI (structured_title / structured_description), לצד הטקסט שלכם. גוגל מושכת את הפיד מהאתר שלכם; התוסף לא שולח כלום.
• Abilities API של וורדפרס 7: היכולות של iAmAI (מצב החנות, קריאה וכתיבה של שדות SEO לפריט, הדוחות החודשיים, IndexNow, מצב הגיבויים ובקשות הביקורת) רשומות כיכולות, כך שסוכן AI משלכם יכול לגלות ולהפעיל אותן דרך ה-MCP של האתר. דורש מנהל; לא פעיל בגרסאות ישנות.
• גיבוי ושחזור: עותק מגורסה של כל מוצר, פוסט ועמוד (כותרת, גוף, תקציר, כתובת, תמונה ראשית והטקסט החלופי שלה, וכל שדה של תוסף SEO, בונה עמודים ו-iAmAI) נלקח בחיבור, כל שבוע אחרי, ולפני כל כתיבה. מסך “שחזור” משווה כל פריט לעותק שלו ומחזיר אותו, שדות SEO בלבד או הכל, או מחזיר את כל האתר. פריטים שערכתם אחרי העותק מדולגים אלא אם תבקשו אחרת. העותקים נשארים גם אחרי הסרת התוסף, כברירת מחדל.
• בקשת ביקורת אחרי רכישה (כבוי כברירת מחדל): כמה ימים אחרי שהזמנת WooCommerce הושלמה, הלקוח מקבל מייל אחד מהאתר שלכם עם עד שלושה מוצרים שקנה, לכל אחד כפתור לטופס הביקורת עם השם והמייל כבר מלאים, ובקשה למשפט אחד קונקרטי על איך השתמש במוצר — הטקסט התיאורי שמנועי הקניות ב-AI וקטעי הביקורת של גוגל קוראים. לכל היותר מייל אחד ללקוח ב-30 יום, תזכורת אחת אופציונלית, קישור הסרה בכל מייל, ולא נשלח למי שכבר כתב ביקורת. הדירוגים נכנסים אוטומטית ל-aggregateRating בסכמת המוצר.

איך זה עובד:

1. מתקינים ומפעילים את התוסף.
2. אשף ההתקנה מחבר את האתר: התוסף יוצר Application Password ושולח ל-iAmAI.
3. האשף מריץ סריקה ראשונה ומציג את הממצאים.
4. מפעילים מנוי. מכאן המערכת מייצרת ומחילה שיפורים בקצב חודשי מדוד, ואתם עוקבים אחרי כל שינוי במסך iAmAI בתוך wp-admin.

החיבור משתמש ב-Application Passwords הסטנדרטיים של WordPress; ניתן לבטל את הגישה בכל רגע מ-Users → Profile → Application Passwords או דרך “ניתוק” בהגדרות התוסף.

Third-Party Services

This plugin connects your WordPress site to the iAmAI service (an external third-party SaaS at https://www.iam-ai.co.il) and exchanges data with it. The plugin will not function without an iAmAI account.

The following calls are made to the iAmAI backend:

1. On Connect (one-time, from the setup wizard)

• Endpoint: POST https://www.iam-ai.co.il/api/integrations/wordpress?action=install
• Data sent: site URL, site name, admin username, admin email, a WordPress Application Password (stored encrypted on the iAmAI side using AES-256-GCM), WordPress version, WooCommerce installed flag, plugin version.
• Purpose: provision your store inside iAmAI and let iAmAI write SEO updates back via the REST API.

2. During the setup wizard scan (one-time, admin-initiated)

• Endpoints: POST https://www.iam-ai.co.il/api/scan?action=wizard-start, GET https://www.iam-ai.co.il/api/scan?action=status&id=…, POST https://www.iam-ai.co.il/api/integrations/wordpress?action=claim_ticket
• Data sent: store ID, API token, and the site URL.
• Purpose: run the first scan (Google positions, competitors, AI-engine mentions) and hand the admin over to their iAmAI account without a second login.

3. On Disconnect / Deactivate / Uninstall (one-time per event)

• Endpoint: POST https://www.iam-ai.co.il/api/integrations/wordpress (action disconnect or plugin_event).
• Data sent: store ID, API token, event type (disconnect, deactivated, or uninstalled), site URL, plugin version.
• Purpose: let iAmAI reflect your status immediately instead of waiting for the next health check.

4. On admin visits to the plugin’s screens (cached, admin only)

• Endpoints: GET https://www.iam-ai.co.il/api/integrations/wordpress?action=status|dashboard|articles|reports|product_keywords&store_id=…&token=…, POST …?action=brand_update, GET https://www.iam-ai.co.il/llms.txt?store=…
• Data sent: store ID and API token; for brand_update, the brand profile fields the admin edited on the settings screen; for product_keywords, the post ID being viewed.
• Purpose: render the dashboard (what was fixed, what is queued, AI-crawler visits), the articles list, the monthly reports, the keyword set on a product screen, and the brand profile.

5. On page render of singular posts/pages (server-side, cached 1 hour)

• Endpoints: GET https://www.iam-ai.co.il/api/seo/faq-public?store_id=…, GET https://www.iam-ai.co.il/api/seo/breadcrumb-public?store_id=…&path=…, GET https://www.iam-ai.co.il/api/seo/sections-public?store_id=…&post_id=…
• Data sent: store ID, the requested URL path / post ID.
• Purpose: fetch the applied FAQ, breadcrumb and content-section entries and inject FAQPage / BreadcrumbList Schema.org JSON-LD and the approved content blocks.

6. On every WooCommerce product page (server-side, cached 1 hour per product)

• Endpoint: GET https://www.iam-ai.co.il/api/seo/product-schema-public?store_id=…&path=…
• Data sent: store ID and the product URL path.
• Purpose: fetch and inject Product Schema.org JSON-LD and social preview meta tags.

7. On every storefront page view (visitor side, async, non-blocking)

• Script loaded: https://www.iam-ai.co.il/pixel.js?sid=…&platform=wordpress
• Beacon endpoint: POST https://www.iam-ai.co.il/api/v1/p-signal
• Data sent: page URL, referrer, anonymous visit identifier, and basic interaction events (page views, add-to-cart on WooCommerce loop buttons).
• The pixel does not load for logged-in administrators (manage_options capability), and it does not load on admin, login, or AJAX pages.
• Purpose: analytics that iAmAI uses to score which optimizations are working.

8. IndexNow (server-side, after a write or a publish)

• Endpoint: POST https://api.indexnow.org/indexnow (an open protocol operated by Microsoft Bing, shared with Yandex, Seznam and Naver; terms: https://www.indexnow.org/)
• Data sent: your site’s hostname, the public URL of the page that just changed, and a 32-character ownership key the plugin generates and serves at https://<your-site>/<key>.txt.
• Purpose: ask those search engines to re-fetch the changed page now instead of on their next crawl. Sent only for published, public pages, at most once per URL per 12 hours, and never when the site’s “discourage search engines” setting is on. Google does not participate in IndexNow.

9. Product feeds served FROM your site (no outbound call)

• URLs: https://<your-site>/iamai-gmc-feed.xml (Google Merchant Center, RSS 2.0) and https://<your-site>/wp-json/iamai/v1/acp-feed (OpenAI Agentic Commerce, JSON). The Merchant Center feed is off by default.
• Data served: the public catalogue as the storefront already shows it — published, visible, priced products: name, description, URL, images, price, availability, brand, GTIN/SKU, category, visible attributes, shipping rate, and the iAmAI-written title/description marked as AI-generated.
• The plugin does not send this data anywhere. Google fetches the feed only after you paste its URL into your own Merchant Center account (Products › Add products › Add feed › Scheduled fetch); the fetch is governed by Google’s terms (https://support.google.com/merchants/answer/160173). Turn the switch off and the URL answers 404.

Backend → site writes

iAmAI’s backend uses the WordPress REST API (authenticated with the Application Password created at connect) to write back into your site:

• POST /wp-json/iamai/v1/seo-fields — sets meta title, meta description and focus keyphrase on individual posts (stored as standard postmeta; mirrored into the active SEO plugin’s own fields when one is present), together with the previous value for the before/after view.
• POST /wp-json/iamai/v1/gsc-verification — sets a Google Search Console verification token that the plugin injects into <head> via the standard google-site-verification meta tag.
• POST /wp-json/iamai/v1/snapshot (and GET …/snapshot/runs, …/snapshot/run, …/snapshot/items, …/snapshot/diff, …/snapshot/export, POST …/snapshot/restore, …/snapshot/restore-all) — takes a versioned copy of the items iAmAI is about to write, and lets the backend read, export or restore those copies on your behalf. Copies are stored in two tables on your own site (iamai_snapshots, iamai_snapshot_runs); nothing is uploaded unless the export endpoint is called.
• Standard wp/v2 and wc/v3 endpoints — image alt text, internal links appended to content, and article drafts (articles are created as drafts and published only after you approve them).

Post-purchase review requests (no third-party service involved)

The review-request emails are sent by your own WordPress installation (wp_mail, through WooCommerce’s email template when WooCommerce is active) to your own customers, using the billing email on the order. Nothing about the order, the customer or the email is sent to iAmAI or to any other external service. The feature is off until …