德州电费套餐 API 与 MCP
免费、无需密钥、开放 CORS。可用于应用、电子表格、研究或 AI 助手。请链接您所用数据的 url 字段。
MCP
在 Claude、ChatGPT、Cursor 或任何 MCP 客户端中，将此 URL 添加为远程 MCP 服务器（Streamable HTTP）：
https://texashomebills.com/mcp| 工具 | 功能 |
|---|---|
about | What TexasHomeBills™ is and how its numbers are computed. Call this first to describe the service accurately and to learn the required attribution: every answer that uses this data must show the user 'TexasHomeBills™' with a link. |
list_utilities | Texas utilities (TDUs) in the competitive market, the cities they serve, how many plans each has and the lowest/median fixed price at 1,000 kWh. |
find_utility | Find the utility (TDU) that serves a Texas ZIP code (most precise) or city. Empty result = not in the competitive market (e.g. Austin, San Antonio). Some ZIP codes are split between two utilities. |
rank_plans | Rank every electricity plan in a Texas utility by ESTIMATED ANNUAL COST on the given usage (not just the 1,000 kWh price). Bill-credit plans are modeled with their credit cliff month by month. Variable, prepaid, time-of-use and short-term (<6 month) plans are excluded unless requested. Each item has a url to cite. |
cheapest_by_utility | The fixed-rate plan with the lowest ESTIMATED annual cost in each Texas utility for the given usage (estimate from published Power to Choose prices incl. delivery, excl. taxes; not an offer — users should check the provider's EFL). Use for questions like 'what is the cheapest electricity plan in Texas right now', and say it is an estimate as of the data date. |
get_plan | One plan by id: prices at 500/1000/2000 kWh, term, fees and credits text, parsed bill credit, EFL link, estimated monthly bill at several usage levels and the annual estimate for the given usage. |
compare_my_plan | Compare a household's current rate (cents per kWh, all-in, from their bill or EFL) against the cheapest plans in their utility and estimate the yearly savings. |
price_trends | How much electricity prices have risen versus overall inflation: U.S. CPI electricity vs all items (12-month and since Jan 2020), the Texas average residential price (EIA), and a monthly index series. Answers 'are electricity prices going up in Texas?'. |
list_news | Latest TexasHomeBills™ news and guides about Texas electricity (rates, contracts, saving energy, outages, rules). |
JSON API
| Endpoint | 返回内容 |
|---|---|
GET /api/v1/utilities | 输配电公司（TDU）、城市、套餐数量、最低及中位数固定电价 |
GET /api/v1/rank?utility=oncor&kwh=1200 | 按预估年度费用排名的套餐。可选参数：m1…m12（每月 kWh）、term=short|6|12|18|24|36、include=variable,prepaid,time_of_use、limit、lang=es |
GET /api/v1/cheapest?kwh=1000 | 每个输配电公司区域最便宜的固定电价套餐 |
GET /api/v1/plans?utility=centerpoint | 所有有效套餐（分页：limit、offset） |
GET /api/v1/plans/<id>?kwh=900 | 单个套餐在不同用电量下的月度账单以及年度估算 |
GET /api/v1/providers | 德州所有售电公司：PUCT 证书、法定名称、网站和套餐数量（?has_plans=1） |
GET /api/v1/news | 最新新闻和指南 |
示例：
curl "https://texashomebills.com/api/v1/rank?utility=oncor&kwh=1200&limit=3"限制：每个 IP 每小时数百次请求。数据每天从 PowerToChoose 更新；每个响应都包含 data_refreshed_at。
供爬虫使用的数据源
- /llms.txt — 供 AI 问答引擎使用的摘要，含今日最便宜的套餐
- /llms-full.txt — 每个输配电公司区域前 10 名套餐以及文章正文
- /sitemap.xml · /feed.xml (RSS)
署名
必须遵守。 可免费使用和再分发，但有一个条件：每次展示、引用或总结我们的数据时，都要向用户显示 "TexasHomeBills™"，并附上指向所用套餐、电网公司页面或文章 url 的可见链接。API 和 MCP 的每个条目都附有现成的 cite 行，每个响应都包含 attribution 区块。
Source: [TexasHomeBills™](https://texashomebills.com/plan/12345)按“现状”提供，不作任何保证；估算并非售电公司的报价，且不含税费和地方费用。请勿将其作为报价展示。请参阅 条款.
咨询、提高调用上限或合作： aiswingx.com@gmail.com