apogeoapi-langchain 0.1.0

LangChain tools for ApogeoAPI — geographic data, live exchange rates, and IP geolocation

apogeoapi-langchain

LangChain tools for ApogeoAPI — geographic data, live exchange rates, and IP geolocation for AI agents.

Installation

pip install apogeoapi-langchain

Quick Start

from apogeoapi_langchain import ApogeoAPIToolkit
from langchain_openai import ChatOpenAI
from langchain.agents import AgentExecutor, create_openai_tools_agent
from langchain_core.prompts import ChatPromptTemplate

# Get your free API key at apogeoapi.com
toolkit = ApogeoAPIToolkit(api_key="your_apogeoapi_key")
tools = toolkit.get_tools()

llm = ChatOpenAI(model="gpt-4o")
prompt = ChatPromptTemplate.from_messages([
    ("system", "You are a helpful assistant with access to geographic and financial data."),
    ("human", "{input}"),
    ("placeholder", "{agent_scratchpad}"),
])

agent = create_openai_tools_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools)

result = executor.invoke({"input": "What's the current EUR to USD rate?"})
print(result["output"])

Available Tools

Tool	Description
get_country	Full data for a country by ISO code
list_countries	All 250+ countries
search_countries	Search by name, region, or currency
get_states	States/provinces for a country
get_cities	150K+ cities with coordinates
get_currency_rate	Live exchange rate for 161 currencies
geolocate_ip	IP geolocation (IPv4 + IPv6)
global_search	Search across countries, states, and cities

Get Your API Key

Free tier available at apogeoapi.com — includes a 14-day full trial.