whatisgithub

What is free-api-discovery?

wearescientist/free-api-discovery — explained in plain English

Analysis updated 2026-06-24

13PythonAudience · developerComplexity · 2/5Setup · easy

In one sentence

A Python routing layer for AI agents that translates natural-language requests into live results from free public APIs, weather, news, stocks, crypto, currency, or finds matching APIs from a curated directory.

Mindmap

mindmap
  root((free-api-discovery))
    What it does
      Route live data requests
      Discover free public APIs
      Token-efficient results
    Live Data Types
      Weather
      Crypto and finance news
      Stock snapshots
      Currency rates
      Country profiles
    API Discovery
      Category filter
      Auth requirement filter
      Keyword search
    Design
      Multiple sources parallel
      Fallback sources
      Source count in result
    Tech Stack
      Python
      Free public APIs
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add live weather, news, or stock data to an AI agent workflow without paying for commercial data APIs.

USE CASE 2

Build a daily digest pipeline that automatically pulls crypto news and currency rates from multiple free sources.

USE CASE 3

Let an AI agent discover relevant free public APIs by category and keyword instead of hard-coding every URL.

What is it built with?

Python

How does it compare?

wearescientist/free-api-discovery1lystore/awaekactashui/sjtu-ppt-template-skill
Stars131313
LanguagePythonPythonPython
Setup difficultyeasymoderatemoderate
Complexity2/52/52/5
Audiencedevelopervibe coderresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 30min
No license file is included in this repository, all rights reserved by default.

So what is it?

Free API Discovery is a Python tool designed to sit between a natural-language request and the data that request is asking for. The README is written in Chinese. The project is described as a "Codex Skill," meaning it is intended to be called by an AI agent or automation system rather than used directly by a human typing commands. The tool handles two kinds of requests. When someone asks for a live result, such as the current weather in Shanghai, the latest cryptocurrency news, a currency conversion, or a stock snapshot, the tool routes that request to a curated set of free public data sources and returns a structured JSON result. It currently supports ten categories of live data: general news, crypto news, financial news, weather, geographic lookups, country profiles, currency exchange rates, quick encyclopedia lookups, cryptocurrency market snapshots, and individual stock context. News results are returned with both the original title and a Chinese summary. When someone asks for sources rather than results, such as finding free GraphQL APIs for market data or listing all available API categories, the tool searches a local index built from two large public API directories. It filters candidates by category, authentication requirements, and keyword relevance, then returns a short list of matching APIs rather than dumping the entire directory into an AI's context. This keeps token usage low when the tool is called repeatedly inside an automated workflow. The design is intentionally conservative about reliability. Free public data sources go down or return empty results unpredictably, so the tool uses multiple sources in parallel for news, has fallback sources for market data, and reports how many sources actually responded in each result rather than presenting results as uniformly authoritative. The tool is not a hosted service and not a comprehensive data platform. It is a local-first routing layer suited to lightweight automation, daily digest pipelines, or agent workflows that need to query public data cheaply and repeatedly. No license file is included in the repository.

Copy-paste prompts

Prompt 1
I am building an AI agent using free-api-discovery as a Codex Skill. How do I call it to get the current weather in Tokyo and the latest cryptocurrency news in a single request?
Prompt 2
Using free-api-discovery, how do I search for free public APIs related to financial market data filtered by category and whether they require authentication?
Prompt 3
I want to wire free-api-discovery into my LangChain agent as a tool. What does the function signature look like and what JSON structure does it return for a weather request?

Frequently asked questions

What is free-api-discovery?

A Python routing layer for AI agents that translates natural-language requests into live results from free public APIs, weather, news, stocks, crypto, currency, or finds matching APIs from a curated directory.

What language is free-api-discovery written in?

Mainly Python. The stack also includes Python.

What license does free-api-discovery use?

No license file is included in this repository, all rights reserved by default.

How hard is free-api-discovery to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is free-api-discovery for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.