har-api-extract/README.md

Extract and format JSON/GraphQL API requests from HAR files for LLM analysis

# har-api-extract

A CLI tool to extract and format JSON/GraphQL API requests from HAR files for LLM analysis.

## Features

- Extract all JSON and GraphQL requests from HAR files
- Format output optimized for LLM analysis
- Compact mode for quick overview
- Read from file or stdin
- Built with TypeScript and Effect

## Installation

### Quick Usage (no install)

```bash
npx har-api-extract network.har
```

### Global Install

```bash
npm install -g har-api-extract

# Then use directly
har-api-extract network.har
```

### From Source

```bash
git clone https://github.com/aaronshaf/har-api-extract.git
cd har-api-extract
npm install
```

## Usage

```bash
# Process a HAR file
har-api-extract network.har

# Compact output
har-api-extract network.har --compact

# Read from stdin
cat network.har | har-api-extract

# Pipe to clipboard (macOS)
har-api-extract network.har | pbcopy

# Include all requests (not just JSON/GraphQL)
har-api-extract network.har --all
```

## Options

- `-c, --compact` - Output in compact format
- `-a, --all` - Include all requests, not just JSON/GraphQL
- `-h, --help` - Show help message

## How to Export HAR Files

1. Open Chrome DevTools (F12 or Cmd+Option+I)
2. Go to Network tab
3. Perform the actions you want to capture
4. Click the download arrow (⬇) in the Network panel toolbar
5. Save as HAR file

## Output Format

### Default (LLM-Optimized)
Provides detailed information about each request including:
- Request method and URL
- Status code and duration
- GraphQL operation names
- Full request/response bodies (JSON formatted)

### Compact Mode
Shows a quick overview with:
- Request type (GraphQL/REST)
- URL and status
- Response time
- Key response fields

## Example

```bash
# Extract GraphQL requests from Apollo Studio
har-api-extract examples/studio.apollographql.com.har --compact

# Output:
# API Requests Overview
# 7 total requests (6 GraphQL, 1 REST)
#
# [GraphQL: RoutedAppMeQuery] POST https://graphql.api.apollographql.com/api/graphql -> 200 (42ms)
#   Response keys: me
# ...
```