SkillFoxx

Astrologer API skill

A skill teaching an agent to call 31 Astrologer API endpoints for natal charts, synastry, transits and moon phases as SVG and JSON.

  • 140 ★ on the repository
  • Last commit
  • AGPL-3.0
Skill

Extended access

Why this level

  • Requests send a person's name, birth date, time and place to a service.
  • The RapidAPI key gives paid access, and a leak spends your quota.
All reasons and checks

g-battaglia/astrologer-apiAuthor:g-battaglia

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/astrologer-api

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Requests send a person's name, birth date, time and place to a service.
  • The RapidAPI key gives paid access, and a leak spends your quota.

This is third-party code. Review the repository files before installing.

What it does

Astrologer API is a service on the Kerykeion engine that computes natal charts, synastry, transits, composites, returns and moon phases and returns SVG diagrams and JSON data. The repository holds an `astrologer-api` skill for agents and MCP server code. The skill covers all 31 RapidAPI endpoints, request examples, chart options, SVG responses, server-side Python and JavaScript clients and error handling. Calls need your own RapidAPI key, kept on the server. Requests go to `astrologer.p.rapidapi.com/api/v6`.

Who it is for. Developers of astrology apps and compatibility services who wire up the API through an agent. Needs a RapidAPI key.

Good fit when

  • An app needs a natal chart as SVG plus data for the interface.
  • Synastry and a compatibility score for a pair.
  • Current transits and moon phase on a page.
  • A server-side Python or JavaScript client built from ready examples.

Not a fit when

  • An offline calculation without an external service is needed, as the API is paid and networked.
  • The key would go into browser client code.
  • Astrological results would be used as health or money advice.

Example request

Use the astrologer-api skill and write a server-side natal chart call with the dark theme, taking the key from an environment variable.

Limitations

The skill does not replace a subscription: a RapidAPI key is needed for every request and limits depend on the plan. Never embed the key in client code; keep it on the server. Requests carry a person's name, birth date, time and place, which is personal data. The repository is AGPL-3.0, which matters when hosting your own copy. Astrological results are not suitable as health or money advice. The last commit is from 6 November 2026.

How to disable. Delete the `astrologer-api` folder from the agent skills directory and revoke the RapidAPI key if it is no longer needed.

FAQ

How many endpoints does the skill cover?

All 31 RapidAPI endpoints: charts, chart data, returns, transits, compatibility, moon phases and helpers.

Which headers does a request need?

`X-RapidAPI-Key` with your key and `X-RapidAPI-Host: astrologer.p.rapidapi.com`.

What does a chart endpoint return?

JSON with a status, SVG markup in `chart` and data in `chart_data`. With `split_chart` the wheel and grid arrive separately.

Can the API be called from a browser?

No. The key must stay on the server, which the skill requires.

Does the repository include an MCP server?

Yes, the `mcp` folder holds server code with chart and moon phase tools. The skill remains the main way to connect.

Discussion

No questions or reviews yet.

Skills
Official

Apollo agent skills: Client, Server, iOS, Kotlin, MCP Server, Rover, GraphQL schemas and operations. Install via npx skills.

PluginMinimal access130

A skill and docs for building AstrBot plugins: plugin API, events, messages, platform adapters and docs4agent writing rules

SkillMinimal access77

Auditing skills for GitHub repositories and profiles, WordPress, EmDash and Astro CI, site SEO, text readability and metadata.

SkillExtended access110

Public APIs from the top lists with a daily reachability check: terminal search and a plugin that picks a working one

PluginMinimal access156

A vetted skill registry with a CLI that installs into twenty-plus agents and an MCP server for on-demand skill lookup

SkillExtended access7.2K

The /graphify skill builds a knowledge graph of a project's code, docs and PDFs so the agent queries the graph instead of grepping

SkillExtended access146.8K

README in short

The skill gathers all endpoints, headers and server client examples in one place. Charts arrive as ready SVG with no separate drawing step.

README badge

Report a problem