@cloro-dev/response-parser

A powerful TypeScript library for parsing AI model responses from ChatGPT, Gemini, Perplexity, Copilot, Grok, and Google AI Overview/Mode.

Framework-Agnostic: This library returns HTML strings that can be rendered in any framework (React, Vue, Svelte, vanilla JS, etc.).

• 🤖 Multi-Provider Support: ChatGPT, Gemini, Perplexity, Copilot, AI Overview, AI Mode, Grok
• 🔍 Auto-Detection: Automatically detects the AI provider from response structure
• 🎨 Built-in Styling: Provider-specific styling
• 🔧 Framework-Agnostic: Pure HTML output for any framework
• 🧹 Script removal: Removes <script> and <noscript> elements. This is not a full HTML sanitizer.
• 📦 TypeScript: Full TypeScript support with comprehensive types
• 🎯 Lightweight: No runtime dependencies for core parsing

npm install @cloro-dev/response-parser
# or
yarn add @cloro-dev/response-parser
# or
pnpm add @cloro-dev/response-parser

This library parses AI responses and returns HTML strings. You can render the HTML in any framework.

Security: The parser removes only <script> and <noscript> elements. It does not remove event handler attributes (for example onerror=) or javascript: URLs. If the HTML comes from a source that you do not trust, sanitize parsed.html with a full HTML sanitizer (for example DOMPurify) before you render it.

import { parseAiResponse, detectProvider } from "@cloro-dev/response-parser";

// Auto-detect provider and parse
const response = await fetchAIResponse();
const parsed = parseAiResponse(response);

console.log(parsed.provider); // 'CHATGPT' | 'GEMINI' | etc.
console.log(parsed.html); // HTML with <script> and <noscript> elements removed
console.log(parsed.text); // Plain text version

import { parseAiResponse } from "@cloro-dev/response-parser";

function MyComponent() {
  const parsed = parseAiResponse(aiResponse, {
    removeLinks: true
  });

  return (
    <div dangerouslySetInnerHTML={{ __html: parsed.html }} />
  );
}

<script setup>
import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});
</script>

<template>
  <div v-html="parsed.html"></div>
</template>

<script>
import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});
</script>

<div>{@html parsed.html}</div>

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(aiResponse, {
  removeLinks: true
});

document.getElementById('output').innerHTML = parsed.html;

Parse an AI response with auto-detected provider.

Options:

• removeLinks: boolean - Remove all hyperlinks from HTML (default: false)
• removeHeader: boolean - Remove navigation bar/header (default: false; true for AI Overview & AI Mode. ChatGPT, Perplexity, Gemini, Copilot, Grok, AI Overview & AI Mode)
• removeFooter: boolean - Remove follow-up input box/footer (default: false; true for AI Overview & AI Mode. ChatGPT, Perplexity, Gemini, Copilot, Grok, AI Overview & AI Mode)
• removeSidebar: boolean - Remove sidebar (default: false, ChatGPT, Gemini, Perplexity, Copilot & AI Mode)
• removeSources: boolean - Remove sources/references panel (default: false, ChatGPT, Gemini, Perplexity, Copilot & Grok)

Note: Cookie/privacy banners are automatically removed for ChatGPT, AI Mode, Copilot, Grok, and Perplexity — no option needed. Sign-in prompts are automatically removed for Gemini and Perplexity.

Returns: ParsedResponse | null

interface ParsedResponse {
  provider: AIProvider;
  html: string;
  text: string;
  sources?: Array<{
    title: string;
    url: string;
    snippet?: string;
  }>;
}

Detect the AI provider from a response.

Returns: AIProvider | null

type AIProvider =
  | 'CHATGPT'
  | 'GEMINI'
  | 'PERPLEXITY'
  | 'COPILOT'
  | 'AIOVERVIEW'
  | 'AIMODE'
  | 'GROK';

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  removeLinks: true, // Removes all <a> tags, keeps text
});

const parsed = parseAiResponse(response, {
  removeHeader: true,  // Remove top navigation bar
  removeFooter: true,  // Remove follow-up input box
  removeLinks: true,   // Remove all hyperlinks
  removeSources: true, // Remove sources/references panel
});

import { parseAiResponse, AIProvider } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  provider: "CHATGPT",
});

import { detectProvider } from "@cloro-dev/response-parser";

const provider = detectProvider(response);
console.log(`Detected: ${provider}`); // 'CHATGPT' | 'GEMINI' | etc.

If you were using React components from v0.1.x, here's how to migrate:

import { ResponseRenderer } from "@cloro-dev/response-parser/react";

<ResponseRenderer
  response={response}
  removeLinks={true}
  onProviderDetected={(provider) => console.log("Detected:", provider)}
/>

import { parseAiResponse } from "@cloro-dev/response-parser";

const parsed = parseAiResponse(response, {
  removeLinks: true
});

console.log("Detected:", parsed.provider);

<div dangerouslySetInnerHTML={{ __html: parsed.html }} />

The core parsing logic is identical - you just need to handle the HTML rendering yourself in your framework of choice.

• First release from the Publish workflow, with npm Trusted Publishing and provenance. No library changes

• ✅ Fixed The README said that the parser sanitizes HTML. It removes only <script> and <noscript> elements. A new Security note tells you to sanitize untrusted HTML before you render it
• ✅ Fixed The package.json repository URL now points to cloro-dev/response-parser

• ✅ Fixed ChatGPT removeSources now hides the open sources dialog of the mobile page

• ✅ Fixed require("@cloro-dev/response-parser") failed with exports is not defined. The CommonJS build is now dist/index.cjs
• ✅ Fixed Perplexity removeSources now hides the open "Sources" popover
• ✅ Fixed Perplexity cookie banner (new markup) and sign-in prompts are now always hidden
• ✅ Fixed Copilot removeHeader and removeSidebar no longer break the page layout. removeSidebar no longer hides the references panel
• ✅ Fixed Copilot removeHeader now hides the date divider
• ✅ Fixed ChatGPT removeSources now hides the sources flyout and the sources sheet on all pages
• ✅ Fixed ChatGPT removeFooter and removeSidebar no longer change the page structure
• ✅ Fixed Gemini sign-in prompt is now always hidden
• ✅ Fixed AI Overview removeFooter now hides the Google footer
• ✅ Fixed Provider detection no longer depends on pattern order for Gemini pages, and no longer reports a Google result page that links to Gemini as Gemini

• ✅ Added Perplexity removeSidebar support (left navigation removal)
• ✅ Fixed Perplexity layout rendering in iframes (CSS overrides for single-column flow)
• ✅ Fixed Perplexity removeFooter now hides the "Ask a follow-up" bar via CSS
• ✅ Fixed ChatGPT removeFooter now hides the composer input form and collapses blank space
• ✅ Fixed ChatGPT removeSidebar now hides leftover sidebar items via CSS
• ✅ Fixed AI Mode removeHeader now hides the "New thread" compose button
• ✅ Fixed Copilot removeHeader now hides the sticky header (share button)
• ✅ Improved CSS overrides are now conditional — only injected when the corresponding remove* option is true (Perplexity, ChatGPT, Copilot)

• ✅ Added ChatGPT automatic cookie banner removal
• ✅ Fixed Copilot sources removal regex to handle variable panel widths

• ✅ Added Copilot removeSources and removeSidebar support
• ✅ Added Copilot automatic cookie banner removal
• ✅ Added AI Mode removeSidebar support (history panel removal)
• ✅ Fixed AI Mode sidebar/footer removal and detection
• ✅ Added AI Mode automatic cookie consent banner hiding

• ✅ Added removeSources option for Gemini, Perplexity, and Grok
• ✅ Added automatic cookie/privacy banner removal for Perplexity and Grok
• ✅ Fixed Perplexity collapsed answer container (JS animation height workaround)

• ✅ Added Grok provider support
• ✅ Simplified codebase and removed colour inversion

• ✅ Removed React components and hooks (now framework-agnostic)
• ✅ Removed React peer dependency
• ✅ Simplified API to return pure HTML strings
• ✅ Keep core parsing logic (unchanged)

• ✅ Renamed removeNavbar → removeHeader (removes navigation bar/header)
• ✅ Renamed removeFollowup → removeFooter (removes follow-up input box/footer)
• ✅ Extended removeHeader support to AI Overview and AI Mode
• ✅ Extended removeFooter support to all providers (ChatGPT, Perplexity, Gemini, Copilot, AI Overview, AI Mode)
• ✅ Improved ChatGPT styling
• ✅ Updated AI Mode and AI Overview parsers

• ✅ Always removes <script> and <noscript> elements from the HTML
• ✅ Always includes provider-specific styles
• ✅ Always uses provider's base URL for relative links
• ❌ Removed theme option (styles are provider-specific)
• ❌ Removed sanitize option (always enabled)
• ❌ Removed includeStyles option (always enabled)
• ❌ Removed baseUrl option (uses provider default)

# Install dependencies
pnpm install

# Build
pnpm build

# Development mode
pnpm dev

# Type check
pnpm type-check

# Lint
pnpm lint

The Publish workflow publishes the package to npm when a version tag is pushed. It uses npm Trusted Publishing, so you do not need to log in to npm.

1. Add an entry under "What's Changed".

2. Increase the version. This changes package.json and creates a git commit and a v tag:

   npm version patch   # 0.5.2 → 0.5.3
   npm version minor   # 0.5.2 → 0.6.0
   npm version major   # 0.5.2 → 1.0.0

3. Push the commit and the tag. The workflow type-checks, lints, builds and publishes:

   git push --follow-tags

MIT © cloro