copyright-search-cli

A command-line tool for searching the US Copyright Office public records.

Installation

npm install -g copyright-search-cli

Usage

Basic Search

copyright-search search "Emily Henry"

Exact Phrase Search

Use quotes within your query for exact phrase matching:

copyright-search search '"FUNNY STORY" Emily Henry'

Pagination

# Get page 2 with 20 results per page
copyright-search search "Stephen King" --page 2 --per-page 20

JSON Output

Use the --json flag for machine-readable output:

copyright-search --json search "Taylor Swift"

# Pipe to jq for processing
copyright-search --json search "Beatles" | jq '.data[].hit.title_concatenated'

Commands

search

Search for copyright records in the US Copyright Office database.

Usage: copyright-search search [options] <query>

Arguments:
  query                    Search query (use quotes for exact phrases)

Options:
  -p, --page <number>      Page number (default: "1")
  -n, --per-page <number>  Results per page (default: "10")
  -h, --help               display help for command

Global Options

| Option | Description | |--------|-------------| | --json | Output results as JSON | | -V, --version | Output version number | | -h, --help | Display help |

Example Output

$ copyright-search search '"FUNNY STORY" Emily Henry'

Found 1 result:
[1] Title: FUNNY STORY.
Registration #: TX0009406047
Registration Date: 2024-05-10
Type: Text
Parties: Emily Henry Books, LLC (author, claimant)
Claimant(s): Emily Henry Books, LLC.
Author(s): Emily Henry Books, LLC (employer of Emily Henry),
Publication Date: 2024-04-23
Creation Date: 2023
ISBN: 978-0-593-44128-2
Description: Book, 387 p.

Library Usage

You can also use this package as a library:

import { search } from "copyright-search-cli";

const results = await search("Emily Henry", {
  pageNumber: 1,
  recordsPerPage: 10,
});

console.log(results.metadata.hit_count);
console.log(results.data[0].hit.title_concatenated);

API Reference

This tool queries the US Copyright Office Public Records Search API:

https://api.publicrecords.copyright.gov/search_service_external/simple_search_dsl

License

MIT