finpeakinc/frevana-skills

backlinks-index

Use when the user asks for external backlink/inbound-link index freshness, total indexed external links, or overall backlink database status.

First seen Jul 15, 2026

Installation

$ npx skills add finpeakinc/frevana-skills --skill backlinks-index

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from finpeakinc/frevana-skills · top by installs.

npx skills add finpeakinc/frevana-skills

Browse all from finpeakinc/frevana-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 2
License MIT
Default branch master
Open issues 1
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,787 B
  • docs SUMMARY.md 164 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

Backlinks Index

Call Frevana's /service/backlinks/index endpoint and return the Backlinks API response unchanged.

Purpose

This skill is for backlink index/database freshness, total indexed backlinks, or overall backlink storage status.

Required input:

  • none

Output:

  • validated response JSON from Frevana/Backlinks provider

This skill validates that the response is JSON and returns it unchanged. Do not rewrite or reshape the returned data unless the user explicitly asks for a transformation.

What This Skill Needs

  • FREVANA_TOKEN in the environment variables, or an explicit --token override for the current run
  • curl
  • bash
  • python3

Execution Order

  1. Confirm the user has provided the required input.
  2. Prefer the bundled script over ad hoc curl commands.
  3. Let the script read FREVANA_TOKEN first.
  4. In interactive shell usage, if FREVANA_TOKEN is missing, the script may prompt for it.
  5. In non-interactive or agent workflows, fail fast if the token is missing and tell the user to set FREVANA_TOKEN or pass --token explicitly.
  6. Return the validated response JSON, or summarize it only if the user asks for a summary.
  7. The script saves the JSON response to ./out/ by default.

Command

bash <skill-path>/scripts/get_backlinks_index.sh

Save response JSON to a specific file

bash <skill-path>/scripts/get_backlinks_index.sh \
  --output ./out/backlinks-index-result.json

Request Shape

Frevana endpoint:

GET /service/backlinks/index

Supported request fields for this API:

none

The script only sends fields supported by this API. Do not pass unsupported fields. Do not pass API keys, output paths, or request metadata in the payload; Frevana handles server-side details.

Response Shape

The API returns JSON. This skill validates the response as JSON and returns it unchanged.

Output

  • Success: the script validates that the response body is JSON and prints it to stdout
  • Default file path: ./out/backlinks-index-<UTC timestamp>-<pid>.json
  • With --output: the same JSON is written to the specified file path instead
  • Failure: the script prints the response body or parsing error and exits non-zero

Notes

  • Do not echo the Bearer token back to the user
  • Use --filters-json, --backlinks-filters-json, --custom-mode-json, --targets-json, or --exclude-targets-json for structured values
  • --targets, --exclude-targets, and --order-by accept comma-separated values
  • Boolean options accept true, false, 1, 0, yes, no, on, or off