Skip to content

chore: fix npm search ranking for @etherscan-npm/cli - #13

Closed
homeyong wants to merge 1 commit into
masterfrom
chore/npm-search-metadata
Closed

chore: fix npm search ranking for @etherscan-npm/cli#13
homeyong wants to merge 1 commit into
masterfrom
chore/npm-search-metadata

Conversation

@homeyong

Copy link
Copy Markdown
Collaborator

Problem

A search for `etherscan cli` on npm currently returns:

Rank Package Score
#1#6 @etherscan-npm/cli-* (the 6 platform packages) ~120–128
#12 etherscan-api (competitor) 59
#13 etherscan-cli (competitor) 58
#19 @etherscan-npm/cli (the real package) 51.8

The platform helper packages outrank the actual product — and the product sits below competitors and unrelated cli-* utilities.

Cause

  1. Each platform package's description was literally "Etherscan CLI for Linux x64", matching the query etherscan cli in both name and description → score ~125.
  2. The umbrella's description was "Official command-line interface…" with no literal "CLI", so it matched the query worse than its own plumbing.

Fix

  • Reword all 6 platform descriptions to internal-plumbing text ("<OS/arch> binary for @etherscan-npm/cli. Installed automatically…; do not install directly.") — removes the Etherscan CLI phrase so they stop matching and sink (they carry no keywords and ~0 downloads).
  • Lead the umbrella description with "Etherscan CLI — the official command-line interface (CLI)…" so it matches the query and ranks first.

No code changes. Metadata refreshes on the next published release.

🤖 Generated with Claude Code

A search for "etherscan cli" ranked the 6 platform packages #1-#6 (their
"Etherscan CLI for <os>" descriptions matched the query in both name and
description) while the real @etherscan-npm/cli sat at #19 — below
competitors — because its description said "command-line interface" with
no literal "CLI".

- Reword platform descriptions to internal-plumbing text without the
  "Etherscan CLI" phrase, so they stop matching the query and sink.
- Lead the umbrella description with "Etherscan CLI (CLI)" so it matches
  and ranks first.

Metadata refreshes on the next published release.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@homeyong

Copy link
Copy Markdown
Collaborator Author

Superseded by #14 (combined v1.0.7 release branch).

@homeyong homeyong closed this Aug 19, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant