API & MCP cho các gói điện Texas
Miễn phí, không cần khóa, CORS mở. Dùng trong ứng dụng, bảng tính, nghiên cứu hoặc trợ lý AI. Vui lòng dẫn đường dẫn trong trường url của dữ liệu bạn dùng.
MCP
Thêm URL này làm máy chủ MCP từ xa (Streamable HTTP) trong Claude, ChatGPT, Cursor hoặc bất kỳ ứng dụng MCP nào:
https://texashomebills.com/mcp| Công cụ | Chức năng |
|---|---|
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 | Trả về |
|---|---|
GET /api/v1/utilities | Công ty truyền tải điện (TDU), thành phố, số gói điện, giá cố định thấp nhất và trung vị |
GET /api/v1/rank?utility=oncor&kwh=1200 | Gói điện xếp hạng theo chi phí ước tính hằng năm. Tùy chọn: m1…m12 (kWh hằng tháng), term=short|6|12|18|24|36, include=variable,prepaid,time_of_use, limit, lang=es |
GET /api/v1/cheapest?kwh=1000 | Gói giá cố định rẻ nhất ở mỗi công ty truyền tải điện |
GET /api/v1/plans?utility=centerpoint | Tất cả gói điện đang hoạt động (phân trang: limit, offset) |
GET /api/v1/plans/<id>?kwh=900 | Một gói điện với hóa đơn hằng tháng ở nhiều mức sử dụng và chi phí ước tính hằng năm |
GET /api/v1/providers | Mọi nhà cung cấp điện tại Texas: giấy phép PUCT, tên pháp lý, trang web và số gói điện (?has_plans=1) |
GET /api/v1/news | Tin tức và hướng dẫn mới nhất |
Ví dụ:
curl "https://texashomebills.com/api/v1/rank?utility=oncor&kwh=1200&limit=3"Giới hạn: vài trăm yêu cầu mỗi giờ cho mỗi IP. Dữ liệu được cập nhật hằng ngày từ PowerToChoose; mỗi phản hồi có trường data_refreshed_at.
Nguồn dữ liệu cho trình thu thập
- /llms.txt — bản tóm tắt cho các công cụ trả lời AI, kèm các gói rẻ nhất hôm nay
- /llms-full.txt — 10 gói hàng đầu mỗi công ty truyền tải điện kèm nội dung bài viết
- /sitemap.xml · /feed.xml (RSS)
Ghi nguồn
Bắt buộc. Được tự do sử dụng và phân phối lại với một điều kiện: mỗi khi hiển thị, trích dẫn hoặc tóm tắt dữ liệu của chúng tôi, hãy cho người dùng thấy "TexasHomeBills™" kèm liên kết hiển thị rõ tới url của gói điện, trang công ty truyền tải hoặc bài viết bạn đã dùng. Mỗi mục trong API và MCP đều có sẵn dòng cite, và mỗi phản hồi đều có khối attribution.
Source: [TexasHomeBills™](https://texashomebills.com/plan/12345)Được cung cấp theo hiện trạng, không có bảo đảm; các ước tính không phải lời chào bán của nhà cung cấp và chưa gồm thuế và phí địa phương. Vui lòng không trình bày chúng như báo giá. Xem Điều khoản.
Câu hỏi, nâng giới hạn hoặc hợp tác: aiswingx.com@gmail.com