explaingit

wearescientist/free-api-discovery

13PythonAudience · developerComplexity · 2/5Setup · easy

TLDR

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

Things people build with this

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.

Tech stack

Python

Getting it running

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

In plain English

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?
Open on GitHub → Explain another repo

← wearescientist on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.