Windsor.ai Integration

Connect your own Windsor.ai account so your Chipp AI can measure whether your SEO and AEO work is paying off. It reads organic search results, referral traffic, conversions and attribution from the sources you connected to Windsor.ai, and compares the period before a change with the period after it.

This is the reporting step of Chipp’s SEO and AEO (answer engine optimization) toolkit. It only reads data. It cannot change anything in Windsor.ai or in your accounts, and it never edits or publishes your website.

Whose credentials are used

The connection is yours. You paste your own Windsor.ai API key, and Chipp never holds a Windsor.ai credential for you.

• Windsor.ai only accepts an API key for this kind of access. Its OAuth sign-in is for AI chat apps that use the Windsor.ai MCP server, so there is no “Connect with Windsor.ai” button here.
• Chipp stores your key encrypted, never shows it again, and never sends it to the AI model.
• Calls use your own Windsor.ai plan and limits (600 requests a minute and 10,000 a day).
• To stop access, disconnect in Brain > Integrations (Chipp deletes the stored key), or regenerate your API key in Windsor.ai.

What you need first

The AI can only read sources you connected in Windsor.ai. Before you connect:

• Connect Google Search Console for search clicks, impressions, queries, pages and average position.
• Connect Google Analytics 4 for sessions by channel and source, referral traffic, visits from AI assistants that identify themselves, and conversions.
• Optionally connect Bing Webmaster Tools and your ad platforms.

You choose the sources

Connecting is not consent to use everything your key can reach. After you connect, click Choose sources and tick the sources and accounts your AI may read. You only see sources and accounts your own key can reach.

• Nothing is allowed until you save at least one account. Until then every tool answers that you have not chosen sources yet.
• The AI can only read what you ticked. If it names another source or account, the request is refused before anything is sent to Windsor.ai.
• Every request is limited to the accounts you allowed, and the rows that come back are checked again, so another account is never shown.
• You can allow up to 15 sources and 10 accounts for each. A new account you connect to Windsor.ai later stays off until you choose it.
• Databases, data warehouses, payroll, banking, identity and accounting sources are never offered, and neither is Windsor.ai’s blended “all” source.
• Disconnecting and connecting again clears your choice, so you choose again.

What the AI can do

Tool	What it does
windsor_list_sources	Lists the sources and accounts you allowed and checks they are still connected in Windsor.ai
windsor_list_fields	Lists the metrics and dimensions a source offers, including your custom fields
windsor_run_report	Runs one report: what to group by, which numbers, a date range, filters, sorting and paging
windsor_compare_periods	Compares the same numbers before and after a change date, or between two periods you choose

Examples your AI can answer: which pages and queries brought organic clicks last month, how organic and referral sessions changed after you published new titles, which AI assistants sent visits, and which pages lost clicks.

Reports

• Dates. You give a date range as the last N days, or from and to dates. Every answer shows the exact dates. Each day is read in the source account’s own time zone.
• Rows. One report returns up to 200 rows (50 by default) and up to 12 fields. Windsor.ai has no paging of its own, so Chipp reads up to 5,000 rows once, sorts them, and your AI can ask for the next page. If a report hits the 5,000 row limit, the answer says it may be incomplete and suggests a shorter range, a filter or fewer dimensions.
• Grouping. Windsor.ai groups rows by the dimensions you ask for and adds or averages the numbers for each group. With no dimension you get one total row. Averages such as position and click-through rate are not added up.
• Currency and time zone. When the source reports them (for example a GA4 property’s currency and time zone), they are shown with the accounts.
• Field changes. Sources rename and remove fields. A field Windsor.ai no longer lists is refused with its name, and your AI is pointed to the current list.
• Several accounts. If you allowed more than one account for a source, each row is for one account.

Before and after a change

Tell your AI the day a change went live. It compares the days before with the days after and ranks what changed most.

• It checks the periods for you: unequal lengths, periods shorter than a week, recent days that are still arriving (Search Console reports 2 to 3 days late), and rows that appear in only one period.
• You can ask it to skip the first days after the change, so search engines and analytics have time to catch up.
• Your AI can add notes next to the numbers: what you changed and what the other SEO and AEO tools found (PageSpeed, Semrush, Bing, IndexNow, Cloudflare).

A comparison shows what changed, not why. Rankings, traffic and conversions move for many reasons: seasons, search engine updates, campaigns, tracking and consent changes, and data still arriving. Your AI is told not to say that a change caused a result.

Attribution and source limits

Every answer carries the limits of its source. In short:

• Search Console shows Google search performance only. It has no conversions, and Google hides rare queries, so a total can be larger than the rows add up to.
• Google Analytics 4 assigns visits to channels with Google’s own rules and attributes conversions with the model set on your GA4 property. Visits from AI assistants often show up as referral or direct traffic, so a filter on a source name finds only the visits that identify themselves. Small groups can be thresholded.
• Ad platforms report conversions under their own attribution windows.
• Across sources, Windsor.ai does not re-attribute or remove duplicates. The same sale reported by two sources is counted by both, so do not add numbers from different sources together.

Connecting

Limits

• Everything is read-only. There is no way to create, change or remove anything in Windsor.ai, and nothing on your website is published automatically. Suggestions go to you and your site editor.
• Freshness and history depend on each source and on your Windsor.ai plan.
• Chipp allows up to 20 Windsor.ai requests a minute for each app, so a busy AI cannot use up your own daily limit. A comparison uses two.
• If Windsor.ai limits your key, your AI tells you to wait.

Troubleshooting

Message	What to do
Windsor.ai did not accept that API key	Copy the current key from Windsor.ai and connect again, then choose sources again
You have not chosen which sources your AI may use	Open Integrations, Windsor.ai, Choose sources
That source is not on your allowed list	Add the source in Choose sources
An allowed account is no longer connected	Reconnect it in Windsor.ai, or choose your accounts again
Windsor.ai does not know that source	Connect the source in Windsor.ai first
A field is not listed for the source	Ask your AI to list the fields again. The source may have renamed it
The report hit the row limit	Ask for a shorter date range, a filter or fewer groupings
Windsor.ai is limiting this key	Wait a few minutes, or until tomorrow for the daily limit

Billing

Windsor.ai tool calls use your standard Chipp LLM token billing. Your Windsor.ai plan is billed by Windsor.ai.