### Install instgame-cli from Source

Source: https://github.com/instgame/cli/blob/main/README.md

Clone the repository and install the CLI globally from the source code.

```bash
git clone git@github.com:instgame/cli.git
cd cli
npm install -g .
```

--------------------------------

### Install instgame-cli

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Install the CLI globally using npm or use npx for immediate execution without installation.

```bash
npm install -g @instgame/cli
```

```bash
npx @instgame/cli <command>
```

--------------------------------

### Start mock API server

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `serve` command to start a local mock API server. Specify a custom port with the `-p` flag if needed.

```bash
node bin/cli.js serve          # starts at 127.0.0.1:3000
node bin/cli.js serve -p 8080  # custom port
```

--------------------------------

### Start Mock API Server with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Use the 'serve' command to start a local mock API server for integrating games. Specify a custom port if needed.

```bash
instgame serve                    # starts at 127.0.0.1:3000
```

```bash
instgame serve -p 8080            # custom port
```

--------------------------------

### Start Mock API Server

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Start a local mock API server to serve game data. Useful for integrating games into H5 sites.

```APIDOC
## Start Mock API Server

### Description
Start a local mock API server to serve game data. Useful for integrating games into H5 sites.

### Command
`node bin/cli.js serve`

### Options
- `-p <port>` (integer) - Optional - Specify a custom port for the server. Defaults to 3000.

### API Endpoints
- `GET /api/games?count=<number>` - Get a specified number of random games.
- `GET /api/games?category=<category>&count=<number>` - Get filtered random games by category.
- `GET /api/games?search=<search_term>&count=<number>` - Get fuzzy search results.
- `GET /api/latest?count=<number>` - Get the latest updated games.
- `GET /api/latest?count=<number>&sort=created` - Get the newest created games.
- `GET /api/categories` - Get a list of categories with game counts.
- `GET /api/tags` - Get a list of tags with game counts.
- `GET /api/health` - Check the server status.

### Game Object Structure
Each game object in responses contains: `id`, `slug`, `name`, `playUrl`, `indexUrl`, `icon`, `banner`, `categoryName`, `tagNames`, `orientation`, `createdAt`, `updatedAt`.

### Example
```bash
node bin/cli.js serve
node bin/cli.js serve -p 8080
```
```

--------------------------------

### Install instgame-cli Globally

Source: https://github.com/instgame/cli/blob/main/README.md

Install the CLI tool globally using npm for command-line access.

```bash
npm install -g @instgame/cli
```

--------------------------------

### Serve Mock API

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Start a local mock API server to serve game catalog data.

```APIDOC
## Serve Mock API Server

### Description
Starts a local HTTP server that provides a mock API for the game catalog. This is useful for developers to integrate games into their applications without direct access to the live API.

### Command
```bash
node bin/cli.js serve
```

### Options
- `-p <port>` (integer): Specify a custom port for the server. Defaults to 3000.

### Endpoints
- `GET /api/games`: Returns random games across categories. Query Params: `?count=<number>`.
- `GET /api/games`: Returns filtered random games. Query Params: `?category=<category_name>&count=<number>`.
- `GET /api/games`: Returns fuzzy search results. Query Params: `?search=<search_term>&count=<number>`.
- `GET /api/latest`: Returns the latest updated games. Query Params: `?count=<number>`.
- `GET /api/latest`: Returns games sorted by creation time. Query Params: `?count=<number>&sort=created`.
- `GET /api/categories`: Returns a list of available categories.
- `GET /api/tags`: Returns a list of available tags.
- `GET /api/health`: Health check endpoint.

### Game Object Fields
`id`, `slug`, `name`, `playUrl`, `indexUrl`, `icon`, `banner`, `categoryName`, `tagNames`, `orientation`, `createdAt`, `updatedAt`.

### Example
```bash
node bin/cli.js serve
node bin/cli.js serve -p 8080
```
```

--------------------------------

### Start mock API server for development

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Initiate a local mock API server for game data using the 'serve' command. This is recommended for development purposes. You can specify a custom port.

```bash
node bin/cli.js serve                    # 127.0.0.1:3000
```

```bash
node bin/cli.js serve -p 8080            # custom port
```

--------------------------------

### Get JSON Output from instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Use the '-j' flag with 'random', 'list', or 'show' commands to get game data directly as JSON output without starting the server.

```bash
instgame random -j                # JSON array of play URLs
```

```bash
instgame list -j                  # full game data as JSON
```

```bash
instgame show <slug> -j           # single game as JSON
```

--------------------------------

### Serve Mock API Server

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Start a local mock API server for game data integration. The server defaults to port 3000 but can be configured with the '-p' option.

```bash
node bin/cli.js serve                    # starts at 127.0.0.1:3000
```

```bash
node bin/cli.js serve -p 8080            # custom port
```

--------------------------------

### Mock API Server

Source: https://github.com/instgame/cli/blob/main/README.md

Start a local mock API server to integrate H5 games into your development environment.

```APIDOC
## Mock API Server

### Description
Starts a local mock API server for game integration.

### Commands
- `instgame serve`: Starts the server on the default port (3000).
- `instgame serve -p <port>`: Starts the server on a custom port.
```

--------------------------------

### Get random game recommendations

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `random` command to get game recommendations. Specify the number of picks with `-n` or filter by category with `-c`.

```bash
node bin/cli.js random              # 3 random games
node bin/cli.js random -n 10        # 10 random picks
node bin/cli.js random -c "Puzzle"  # from a category
```

--------------------------------

### Integrate Games with Mock API

Source: https://github.com/instgame/cli/blob/main/README.md

JavaScript examples demonstrating how to fetch random games, latest games, and category lists from the mock API server for website integration.

```javascript
// 1. Fetch 5 random games for a recommendation widget
const res = await fetch('http://127.0.0.1:3000/api/games?count=5');
const games = await res.json();
games.forEach(g => {
  console.log(`<iframe src="${g.playUrl}"></iframe>`);
});
```

```javascript
// 2. Fetch 3 latest new games
const latest = await fetch('http://127.0.0.1:3000/api/latest?count=3');
```

```javascript
// 3. Get category list for navigation
const cats = await fetch('http://127.0.0.1:3000/api/categories');
```

--------------------------------

### Run instgame-cli with npx

Source: https://github.com/instgame/cli/blob/main/README.md

Execute instgame-cli commands directly using npx without a global installation.

```bash
npx @instgame/cli <command>
```

--------------------------------

### Get Random Games with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Use the 'random' command to get random game suggestions, with options to specify the number of games or filter by category.

```bash
instgame random                   # 3 random games
```

```bash
instgame random -n 10             # 10 random games
```

```bash
instgame random -c "Sports"       # random picks from a category
```

--------------------------------

### Update instgame-cli

Source: https://github.com/instgame/cli/blob/main/README.md

Update the globally installed instgame-cli to the latest version.

```bash
npm update -g @instgame/cli
```

--------------------------------

### JSON Output (No Server)

Source: https://github.com/instgame/cli/blob/main/README.md

Retrieve game data directly in JSON format without starting the mock API server.

```APIDOC
## JSON Output (No Server)

### Description
Get game data in JSON format directly from the CLI.

### Commands
- `instgame random -j`: Returns a JSON array of play URLs for random games.
- `instgame list -j`: Returns full game data as a JSON array.
- `instgame show <slug> -j`: Returns the data for a single game as a JSON object.
```

--------------------------------

### Fetch game data as JSON

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `-j` flag to output game data directly as JSON without starting a server. This is useful for one-off data fetching.

```bash
node bin/cli.js list -j                     # all games as JSON
node bin/cli.js random -j                   # JSON array of play URLs
node bin/cli.js show <slug> -j              # single game as JSON
node bin/cli.js list -s "puzzle" -j         # search results as JSON
```

--------------------------------

### Random Game Recommendations

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Get random game recommendations. Can specify the number of games and filter by category.

```APIDOC
## Random Game Recommendations

### Description
Get random game recommendations. Can specify the number of games and filter by category.

### Command
`node bin/cli.js random`

### Options
- `-n <count>` (integer) - Optional - The number of random games to pick. Defaults to 3.
- `-c "<category>"` (string) - Optional - Filter random picks by category.
- `-j` - Optional - Output results as JSON (array of play URLs).

### Example
```bash
node bin/cli.js random
node bin/cli.js random -n 10
node bin/cli.js random -c "Puzzle"
```
```

--------------------------------

### Player: Find & Play Games

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Commands for players to discover and play games. Supports searching by name, filtering by category and tags, viewing game details, and getting random recommendations.

```APIDOC
## Search by name (fuzzy, supports typos)
```
node bin/cli.js list -s "billiard"
```

## Filter by category
Available categories: `Sports`, `Puzzle`, `Casual`, `Simulation`, `Adventure`, `Strategy`, `Racing`, `Parkour`, `Dress Up`, `Shooting`, `Action`, `Arcade`, `.io`, `Music`, `Synthesis`, `Battle`, `Break Through`, `Role Playing`, `Board`, `Make Up`, `Operate`, `Card`
```
node bin/cli.js list -c "Sports"
node bin/cli.js list -c "Racing"
```

## Filter by tag
```
node bin/cli.js list -t "Pool"
```

## View game details with play link
```
node bin/cli.js show <slug>
```
Output includes `playUrl` — the direct link to play the game.

## Random recommendations
```
node bin/cli.js random              # 3 random games
node bin/cli.js random -n 10        # 10 random picks
node bin/cli.js random -c "Puzzle"  # from a category
```
```

--------------------------------

### Random Game Picks

Source: https://github.com/instgame/cli/blob/main/README.md

Get random game suggestions, with options to specify the number of games and filter by category.

```APIDOC
## Random Game Picks

### Description
Get random game recommendations.

### Commands
- `instgame random`: Get 3 random games.
- `instgame random -n <count>`: Get a specified number of random games.
- `instgame random -c "<Category>"`: Get random games from a specific category.
```

--------------------------------

### Display help information

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Access comprehensive help and a list of all available commands by running the CLI with the '--help' flag.

```bash
node bin/cli.js --help         # show all commands
```

--------------------------------

### View Game Details with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Use the 'show' command with a game's slug to view its details, including the play URL.

```bash
instgame show 8-ball-billiards-classic
```

--------------------------------

### View game details and play URL

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Retrieve detailed information about a specific game, including a direct play link, by using the 'show' command with the game's slug.

```bash
node bin/cli.js show <slug>
```

--------------------------------

### Show game details

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `show` command with a game slug to retrieve its details, including the `playUrl` for direct embedding.

```bash
node bin/cli.js show 8-ball-billiards-classic
```

--------------------------------

### Sync Game Data with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Update the local game data from the remote source using the 'sync' command.

```bash
instgame sync                     # update game data from remote
```

--------------------------------

### Run Tests for instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Execute the project's test suite using npm test.

```bash
npm test
```

--------------------------------

### List Categories and Tags with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Commands to list all available game categories or tags.

```bash
instgame categories               # list all categories
```

```bash
instgame tags                     # list all tags
```

--------------------------------

### Help Command

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Display help information for all available CLI commands.

```APIDOC
## Help Command

### Description
Displays all available commands and their options for the instgame CLI.

### Command
```bash
node bin/cli.js --help
```
```

--------------------------------

### Developer: Integration Tip

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Guidance on embedding games using the `playUrl` and adjusting iframe dimensions based on game orientation.

```APIDOC
### Integration tip
Use `playUrl` for iframe embedding. Check `orientation` (`"vertical"` or `"horizontal"`) to set iframe dimensions.
```html
<iframe src="https://free.instgame.com/game/8-ball-billiards-classic/instplay.html"></iframe>
```
```

--------------------------------

### List all available categories

Source: https://github.com/instgame/cli/blob/main/AGENT.md

View a list of all supported game categories by running the 'categories' command.

```bash
node bin/cli.js categories     # list all categories
```

--------------------------------

### Developer: Integrate Games - Mock API Server

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Run a local mock API server for development to test game integration. This is the recommended approach for developers.

```APIDOC
## Option 1: Mock API Server (recommended for development)
```
node bin/cli.js serve                    # 127.0.0.1:3000
node bin/cli.js serve -p 8080            # custom port
```

### Endpoints:
- `GET /api/games?count=5` — 5 random games (distributed across categories)
- `GET /api/games?category=Sports&count=5` — filtered random picks
- `GET /api/games?search=billiard&count=3` — fuzzy search results
- `GET /api/latest?count=5` — 5 latest updated games
- `GET /api/latest?count=5&sort=created` — 5 newest created games
- `GET /api/categories` — category list with counts
- `GET /api/tags` — tag list with counts
- `GET /api/health` — server status

Response format: JSON array of game objects with `id`, `slug`, `name`, `playUrl`, `indexUrl`, `icon`, `banner`, `categoryName`, `tagNames`, `orientation`, `createdAt`, `updatedAt`.
```

--------------------------------

### Search and Filter Games with instgame CLI

Source: https://github.com/instgame/cli/blob/main/README.md

Use the 'list' command to browse games, with options for fuzzy search, filtering by category, and filtering by tag.

```bash
instgame list                     # browse all 535+ games
```

```bash
instgame list -s "billiard"       # fuzzy search (typos tolerated)
```

```bash
instgame list -c "Sports"         # filter by category
```

```bash
instgame list -t "Pool"           # filter by tag
```

--------------------------------

### Run instgame-cli commands

Source: https://github.com/instgame/cli/blob/main/AGENT.md

The base command to run any instgame-cli operation. All commands should be executed from the project root directory.

```bash
node bin/cli.js <command> [options]
```

--------------------------------

### Sync game data

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `sync` command to update the local game data catalog.

```bash
node bin/cli.js sync
```

--------------------------------

### List all available tags

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Retrieve a list of all available game tags using the 'tags' command.

```bash
node bin/cli.js tags           # list all tags
```

--------------------------------

### Show Game Details

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Display detailed information for a specific game, including a direct play URL.

```APIDOC
## Show Game Details

### Description
Display detailed information for a specific game, including a direct play URL.

### Command
`node bin/cli.js show <slug>`

### Parameters
- **slug** (string) - Required - The unique identifier of the game.

### Options
- `-j` - Optional - Output results as JSON.

### Example
```bash
node bin/cli.js show 8-ball-billiards-classic
node bin/cli.js show <slug> -j
```
```

--------------------------------

### List All Categories and Tags

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Retrieve a list of all available game categories or tags using dedicated commands. These commands are useful for understanding the available filtering options.

```bash
node bin/cli.js categories     # list all categories
```

```bash
node bin/cli.js tags           # list all tags
```

--------------------------------

### Other Commands

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Utility commands for listing categories, tags, syncing data, and accessing help.

```APIDOC
## Other Commands
```
node bin/cli.js categories     # list all categories
node bin/cli.js tags           # list all tags
node bin/cli.js sync           # download latest catalog from remote
node bin/cli.js --help         # show all commands
```
```

--------------------------------

### List games by category filter

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `-c` flag to filter games by available categories. Available categories include Sports, Puzzle, Casual, and more.

```bash
node bin/cli.js list -c "Sports"
node bin/cli.js list -c "Racing"
```

--------------------------------

### Other Commands

Source: https://github.com/instgame/cli/blob/main/README.md

Utility commands for managing game data and listing categories/tags.

```APIDOC
## Other Commands

### Description
Utility commands for interacting with game data.

### Commands
- `instgame categories`: Lists all available game categories.
- `instgame tags`: Lists all available game tags.
- `instgame sync`: Updates the local game data from the remote source.
```

--------------------------------

### Sync Game Data

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Download the latest game catalog from the remote source.

```APIDOC
## Sync Game Data

### Description
Downloads the latest game catalog from the remote source to update the local `games.json` file.

### Command
```bash
node bin/cli.js sync
```
```

--------------------------------

### Sync Game Data

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Update the local game data from the source.

```APIDOC
## Sync Game Data

### Description
Update the local game data from the source.

### Command
`node bin/cli.js sync`

### Example
```bash
node bin/cli.js sync
```
```

--------------------------------

### View Game Details

Source: https://github.com/instgame/cli/blob/main/README.md

Retrieve detailed information about a specific game, including its play URL, icon, banner, category, and tags.

```APIDOC
## View Game Details

### Description
Show detailed information for a specific game using its slug.

### Command
`instgame show <slug>`

### Parameters
- **slug** (string) - Required - The unique identifier for the game.
```

--------------------------------

### List games by name search

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `-s` flag to search for games by name, supporting fuzzy matching for typos.

```bash
node bin/cli.js list -s "billiard"
node bin/cli.js list -s "puzzle"
```

--------------------------------

### View Game Details

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Retrieve detailed information about a specific game using its slug.

```APIDOC
## View Game Details

### Description
Shows detailed information for a specific game, including its play URL, icon, banner, category, tags, and orientation.

### Command
```bash
node bin/cli.js show <slug>
```

### Parameters
- **slug** (string): The unique identifier for the game.

### Example
```bash
node bin/cli.js show <slug>
```
```

--------------------------------

### Search for games by name

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Use the 'list' command with the '-s' option to search for games by name. Supports fuzzy matching and typos.

```bash
node bin/cli.js list -s "billiard"
```

--------------------------------

### List Categories and Tags

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Retrieve lists of available game categories and tags.

```APIDOC
## List Categories and Tags

### Description
Commands to list all available game categories and tags.

### Commands
- `node bin/cli.js categories`: Lists all available game categories.
- `node bin/cli.js tags`: Lists all available game tags.

### Example
```bash
node bin/cli.js categories
node bin/cli.js tags
```
```

--------------------------------

### Mock API Endpoints

Source: https://github.com/instgame/cli/blob/main/README.md

Details of the API endpoints available when the mock server is running.

```APIDOC
## Mock API Endpoints

### Description
Available endpoints for the mock API server.

#### `GET /api/games`
- **Description**: Retrieves random games, optionally filtered by category or search query.
- **Query Parameters**:
  - `count` (integer) - Optional - The number of games to return.
  - `category` (string) - Optional - Filters games by the specified category.
  - `search` (string) - Optional - Performs a fuzzy search for games matching the query.
- **Examples**:
  - `?count=5`
  - `?category=Sports&count=5`
  - `?search=billiard&count=3`

#### `GET /api/latest`
- **Description**: Retrieves the latest updated or created games.
- **Query Parameters**:
  - `count` (integer) - Optional - The number of games to return (default 10).
  - `sort` (string) - Optional - Sort order, e.g., `created` for creation time.
- **Examples**:
  - `?count=5`
  - `?count=5&sort=created`

#### `GET /api/categories`
- **Description**: Returns a list of available game categories with their counts.

#### `GET /api/tags`
- **Description**: Returns a list of available game tags with their counts.

#### `GET /api/health`
- **Description**: A health check endpoint for the server.
```

--------------------------------

### List games by tag filter

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Use the `-t` flag to filter games by specific tags.

```bash
node bin/cli.js list -t "Pool"
node bin/cli.js list -t "Soccer"
```

--------------------------------

### Developer: Integrate Games - Direct JSON Output

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Commands to output game data directly as JSON, useful for scripting or direct data consumption.

```APIDOC
## Option 2: Direct JSON output
```
node bin/cli.js list -j                     # all games as JSON
node bin/cli.js random -j                   # JSON array of play URLs
node bin/cli.js show <slug> -j              # single game as JSON
node bin/cli.js list -s "puzzle" -j         # search results as JSON
```
```

--------------------------------

### Direct JSON Output

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Output game data directly in JSON format for various operations.

```APIDOC
## Direct JSON Output

### Description
Get game data directly in JSON format for various commands. This is useful for programmatic access and integration.

### Commands with JSON Output
- `node bin/cli.js list -j`: Outputs all games as a JSON array.
- `node bin/cli.js random -j`: Outputs a JSON array of game play URLs.
- `node bin/cli.js show <slug> -j`: Outputs a single game's details as JSON.
- `node bin/cli.js list -s "<search_term>" -j`: Outputs search results as a JSON array.

### Example
```bash
node bin/cli.js list -j
node bin/cli.js random -j
node bin/cli.js show <slug> -j
node bin/cli.js list -s "puzzle" -j
```
```

--------------------------------

### Filter games by tag

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Filter games by applying specific tags using the '-t' option. This allows for more granular selection.

```bash
node bin/cli.js list -t "Pool"
```

--------------------------------

### List Games

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Browse all available games. Supports filtering by name (fuzzy search), category, and tag.

```APIDOC
## List Games

### Description
Browse all available games. Supports filtering by name (fuzzy search), category, and tag.

### Command
`node bin/cli.js list`

### Options
- `-s "<search_term>"` (string) - Optional - Search games by name (supports typos).
- `-c "<category>"` (string) - Optional - Filter games by category. Available categories: `Sports`, `Puzzle`, `Casual`, `Simulation`, `Adventure`, `Strategy`, `Racing`, `Parkour`, `Dress Up`, `Shooting`, `Action`, `Arcade`, `.io`, `Music`, `Synthesis`, `Battle`, `Break Through`, `Role Playing`, `Board`, `Make Up`, `Operate`, `Card`.
- `-t "<tag>"` (string) - Optional - Filter games by tag.
- `-j` - Optional - Output results as JSON.

### Example
```bash
node bin/cli.js list -s "billiard"
node bin/cli.js list -c "Sports"
node bin/cli.js list -t "Pool"
node bin/cli.js list -s "puzzle" -j
```
```

--------------------------------

### Developer: Refresh Game Data

Source: https://github.com/instgame/cli/blob/main/AGENT.md

Command to synchronize the local game catalog with the latest data from the remote source.

```APIDOC
### Refresh game data
```
node bin/cli.js sync
```
```

--------------------------------

### Search Games

Source: https://github.com/instgame/cli/blob/main/README.md

Browse and search for H5 games available on instgame.com. Supports filtering by category and tag, as well as fuzzy searching.

```APIDOC
## Search Games

### Description
Browse all available games or search with specific criteria.

### Commands
- `instgame list`: Browse all games.
- `instgame list -s "<keyword>"`: Fuzzy search for games.
- `instgame list -c "<Category>"`: Filter games by category.
- `instgame list -t "<Tag>"`: Filter games by tag.
```

--------------------------------

### Embed game using iframe

Source: https://github.com/instgame/cli/blob/main/CLAUDE.md

Integrate games into an H5 site by embedding the `playUrl` in an iframe. The `orientation` field can help set appropriate iframe dimensions.

```html
<iframe src="https://free.instgame.com/game/8-ball-billiards-classic/instplay.html"></iframe>
```

--------------------------------

### Search Games

Source: https://github.com/instgame/cli/blob/main/SKILL.md

Search for games by name, category, or tag. The `-s` flag is for fuzzy name search, `-c` for category filtering, and `-t` for tag filtering.

```APIDOC
## Search Games

### Description
Search for games by name (fuzzy), category, or tag.

### Command
```bash
node bin/cli.js list
```

### Options
- `-s "<search_term>"` (string): Fuzzy search by game name.
- `-c "<category_name>"` (string): Filter games by category. Available categories: `Sports`, `Puzzle`, `Casual`, `Simulation`, `Adventure`, `Strategy`, `Racing`, `Parkour`, `Dress Up`, `Shooting`, `Action`, `Arcade`, `.io`, `Music`, `Synthesis`, `Battle`, `Break Through`, `Role Playing`, `Board`, `Make Up`, `Operate`, `Card`.
- `-t "<tag_name>"` (string): Filter games by tag.

### Example
```bash
node bin/cli.js list -s "billiard"
node bin/cli.js list -c "Sports"
node bin/cli.js list -t "Pool"
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.